Skip to main content
GET
GET /v1/token/price-at · 1 credit The price of a token at a past instant: the last trade at or before timestamp on the token’s main market, never a trade after it, with the second of that trade and the market it came from. Up to 100 tokens, each at its own instant, on the batch twin.
timestamp is in unix seconds (a millisecond value is a 400). at is the second of the trade served, at or before timestamp; priceNative is that trade’s price, as decimal text. The market is the one the token’s default candles follow: its main market, and its launch curve for the instants before the graduation (poolAddress names the one that served the trade). The same instant on the same token always answers the same trade, whoever asks.
priceUsd is the price in dollars at the time of the trade: on Solana the dollar value recorded with the swap, on EVM chains the native price at the native coin’s rate of that minute (usdBasis: "trade", the rule of trades and candles in quote=usd). On a chain without a rate series (Story, evm:1514) the dollar figure uses today’s spot (usdBasis: "spot"). priceUsd and usdBasis are null when no rate exists for that minute (an instant before the chain’s rate series starts).
A chain’s native coin and its wrapped form (WETH, WBNB, SOL…) are priced at priceNative "1" by construction, priceUsd being the native coin’s rate at that minute, at the minute of the rate, poolAddress null: on EVM 0x0000…0000 (0xeeee…eeee accepted on input) or the wrapped native, on Solana So11111111111111111111111111111111111111112.
A token that had no trade at or before timestamp on its main market (created later, or the instant precedes its first trade) answers 404 NO_PRICE_AT with details.timestamp; an unknown token answers 404 NOT_FOUND. Neither is billed. Pass a later timestamp, or read /v1/token/pools for the market’s creation date.

Authorizations

Authorization
string
header
required

Your raw API key (not needed on the demo server).

Query Parameters

chain
string
required

Public chain id - evm:<id> or solana (solana:solana accepted).

address
string

Token address (EVM hex, case-insensitive; Solana base58). Or send it as tokenAddress.

tokenAddress
string

The explicit name of address (the token): send one of the two.

timestamp
integer
required

Unix seconds. The price served is the last trade at or before this instant (a millisecond value is a 400). At most 1 day ahead.

Required range: x >= 0

Response

200

Standard { data, meta } envelope.