curl 'https://api.serialized.xyz/v1/token/price-at?chain=solana&address=DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263×tamp=1762000000' \
-H 'Authorization: YOUR_API_KEY'
{
"data": {
"chain": "solana",
"address": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
"tokenAddress": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
"poolAddress": "5zpyutJu9ee6jFymDGoK7F6S5Kczqtc9FomP3ueKuyA9",
"timestamp": 1762000000,
"at": 1761999972,
"priceNative": "0.00000007642689693668835",
"priceUsd": 0.000014244780554807382,
"usdBasis": "trade"
},
"meta": {
"asOf": 1794060000000
}
}
Token Price
Token Price at a date
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.
GET
/
v1
/
token
/
price-at
curl 'https://api.serialized.xyz/v1/token/price-at?chain=solana&address=DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263×tamp=1762000000' \
-H 'Authorization: YOUR_API_KEY'
{
"data": {
"chain": "solana",
"address": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
"tokenAddress": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
"poolAddress": "5zpyutJu9ee6jFymDGoK7F6S5Kczqtc9FomP3ueKuyA9",
"timestamp": 1762000000,
"at": 1761999972,
"priceNative": "0.00000007642689693668835",
"priceUsd": 0.000014244780554807382,
"usdBasis": "trade"
},
"meta": {
"asOf": 1794060000000
}
}
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.curl 'https://api.serialized.xyz/v1/token/price-at?chain=solana&address=DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263×tamp=1762000000' \
-H 'Authorization: YOUR_API_KEY'
{
"data": {
"chain": "solana",
"address": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
"tokenAddress": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
"poolAddress": "5zpyutJu9ee6jFymDGoK7F6S5Kczqtc9FomP3ueKuyA9",
"timestamp": 1762000000,
"at": 1761999972,
"priceNative": "0.00000007642689693668835",
"priceUsd": 0.000014244780554807382,
"usdBasis": "trade"
},
"meta": {
"asOf": 1794060000000
}
}
Query Parameters
Response
200
Standard { data, meta } envelope.