Liquidity rewards

Public and Privy-authenticated liquidity-rewards reads on xo-backend.

Liquidity rewards pay makers for resting qualifying limit orders. Each enrolled market pays CP, USDC, or both.

All paths below sit on the Data API host and use the /api prefix. Use conditionId as marketId. An epoch is a UTC-day index: floor(unix_ms / 86_400_000).

Two surfaces

Prefix	Auth	Use for
/public/liquidity-rewards/*	None	Discovery, wallet lookups, market-day analytics
/liquidity-rewards/*	Privy Bearer required	The signed-in maker (/me binds the session wallet)

Authenticated routes do not accept the orderbook L1/L2 HMAC scheme. Send a Privy access token:

Authorization: Bearer <privy_access_token>

Missing or invalid token → 401. User without access → 403.

The public prefix is separately throttled at 30 requests per 10 seconds. Other Data API REST routes share 100 / 10 seconds.

Wire conventions

• Catalogue and summary BFFs (earning-pools, me/summary, wallet summary) use camelCase.
• Proxied maker / market-day / config payloads use snake_case.
• Money and scores are strings. Keep them as strings in client state.
• Dual-rail (CP + USDC) market-days: use …/markets/{marketId}/me or …/markets/{marketId}/wallets/{wallet}. The CP-only …/epochs/{epoch}/makers list may return 409.

Related

• Rate limits