Authentication
All API endpoints are authenticated using thex-api-key header.
Each key is rate limited per minute by its plan: Basic 5 requests, Premium 10, Enterprise 20.
Responses carry RateLimit-* headers.
Supported chains
Most read endpoints accept achain query parameter. It defaults to SOL, so existing
integrations need no change.
An unrecognised value falls back to
SOL rather than returning an error, except on
/pools/discover, where it matches no pools.
These endpoints are chain-aware:
On
/pools/{poolId}/onchain-stats and /pools/{poolId}/top-lpers, chain is optional: when
omitted it is inferred from the pool ID (0x IDs are Robinhood Chain, anything else Solana).
Every endpoint that filters by protocol takes it as platform, a comma-separated list such as
uniswap_v3,uniswap_v4. The older names protocol (overview, revenue) and type (discover)
are still accepted.
Every other endpoint is Solana only. The remaining /pools/{poolId}/* routes read Meteora
pool state, and the transaction-building, Jito, and RPC routes are Solana specific. See
Robinhood Chain Integration for the response differences and
current data limitations.
Premium endpoints
The following endpoints require a Premium or Enterprise API key plan. Basic API key plan cannot access these routes.
To upgrade, manage your API key and billing in the LP Agent Portal.
When a paid plan ends
Basic is a one-time purchase and does not expire. Premium and Enterprise run for 30 days per payment. When a paid period ends without a renewal:- You own Basic (you bought it, or the key started on Basic before you upgraded): the key goes back to Basic, with Basic’s rate limit and endpoints.
- The key was created by buying Premium or Enterprise directly: there is no Basic to fall back
to. The key stops working and every request returns
401 Unauthorized.