Token Price
GET /v1/tokens/:mint/price returns a token's latest price in USD and SOL, with its market cap and symbol.
- Endpoint
- GET
/v1/tokens/:mint/price - Auth
- API key in the Authorization header
- Live
- The same data as a stream
A price stays readable for 72 hours after the token's last trade; after that, or for a token we have never priced, the response is 404. For SOL itself (So11111111111111111111111111111111111111112) you get SOL's USD price: price.sol is always 1 and source is "internal". USDC and USDT are priced from their market USD rate the same way.
Path parameters
mintstringToken mint address.
Example
DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263
Response fields
Fields of the response body.
typestringAlways "price".
sourcestringThe 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.
mintstringToken mint.
symbolstring | nullThe 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 | nullMarket capitalisation in USD. null when unknown.
For SOL: circulating supply × price. For USDC and USDT: their supply on Solana only.
slotnumberSolana slot the event landed in.
Use for ordering and gap recovery.
timestampnumber | nullWhen 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.
stalebooleanREST 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