Token Price (Batch)

GET /v1/tokens/batch/price returns the latest prices of up to 100 tokens in one request.

Endpoint
GET/v1/tokens/batch/price
Auth
API key in the Authorization header
Live
The same data as a stream

Each unique mint counts as one request against your monthly quota; the call counts as 1 against the per-minute burst limit (see X-Request-Cost). Tokens without a price are left out of the response rather than returned as errors. Same shape as the single-token price endpoint, stale included. No next or window.

Query parameters

A parameter not listed here is rejected with 400 invalid_request, not ignored.

mintsstring

Comma-separated mint addresses (required, max 100 unique; duplicates do not count against the cap).

Example So11111111111111111111111111111111111111112,EKpQGSJtjMFqKZ9KQanSqYXRcF8fBopzLHYxdM65zcjm

Response fields

Fields of the response body.

typestring

Always "price".

sourcestring

The venue of the busiest pool in the price. "internal" for SOL, USDC and USDT, which are priced from their market USD rate rather than a trade.

mintstring

Token mint.

symbolstring | null

The token's on-chain symbol. null until the token is resolved, or when it has none.

A label, not an identity: anyone can name a token USDC, so key on mint.

priceobject

{ sol, usd }: a volume-weighted blend of the token's main pools' latest rates, fees excluded, each converted to SOL through its quote token's current price, so tokens that only trade against other tokens are priced too.

A trade worth under $1 counts toward its pool's volume but doesn't move its rate. For SOL, sol is always 1 and usd is the SOL/USD rate every token's usd is computed with, updated about every 10 seconds (at least every 60). USDC and USDT use their market rate, so a depeg shows.

marketCapUsdnumber | null

Market capitalisation in USD. null when unknown.

For SOL: circulating supply × price. For USDC and USDT: their supply on Solana only.

slotnumber

Solana slot the event landed in.

Use for ordering and gap recovery.

timestampnumber | null

When the trade behind the price happened (unix ms), so a quiet token's timestamp can be minutes or hours old.

For SOL, when the rate was published.

staleboolean

REST only. true when the trade behind the price (timestamp) is over 15 minutes old, or unknown: it's the last known price, so treat it as such.

A price stays readable for 72 hours after the token's last trade, then returns 404.

Last updated · Changelog