> ## Documentation Index
> Fetch the complete documentation index at: https://docs.serialized.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# 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` · **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](https://docs.serialized.xyz/endpoints/token-price-at-batch.md).

> [!NOTE]
>
> `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](https://docs.serialized.xyz/endpoints/token-candles.md) follow: its [main market](https://docs.serialized.xyz/conventions.md#the-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.

> [!NOTE]
>
> `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](https://docs.serialized.xyz/endpoints/token-trades.md) 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).

> [!NOTE]
>
> 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`.

> [!NOTE]
>
> 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`](https://docs.serialized.xyz/endpoints/token-pools) for the market's creation date.

```bash cURL theme={null}
curl 'https://api.serialized.xyz/v1/token/price-at?chain=solana&address=DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263&timestamp=1762000000' \
  -H 'Authorization: YOUR_API_KEY'
```

```json Response theme={null}
{
  "data": {
    "chain": "solana",
    "address": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
    "tokenAddress": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
    "poolAddress": "5zpyutJu9ee6jFymDGoK7F6S5Kczqtc9FomP3ueKuyA9",
    "timestamp": 1762000000,
    "at": 1761999972,
    "priceNative": "0.00000007642689693668835",
    "priceUsd": 0.000014244780554807382,
    "usdBasis": "trade"
  },
  "meta": {
    "asOf": 1794060000000
  }
}
```


## OpenAPI

````yaml openapi.json GET /v1/token/price-at
openapi: 3.1.0
info:
  title: Serialized Data API
  description: >-
    On-chain data for trading apps - tokens, candles, token filters. Built on
    our own indexers. 19 EVM chains + Solana, live.
  version: 0.1.0
servers:
  - url: https://demo.serialized.xyz
    description: 'Demo: no key needed, read endpoints, rate-limited per IP'
  - url: https://api.serialized.xyz
    description: 'Production: your API key in the Authorization header'
security:
  - apiKey: []
  - {}
paths:
  /v1/token/price-at:
    get:
      summary: Token Price at a date
      description: >-
        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.
      operationId: token-price-at
      parameters:
        - schema:
            type: string
            x-default: solana
          in: query
          name: chain
          required: true
          description: Public chain id - `evm:<id>` or `solana` (`solana:solana` accepted).
          example: solana
        - schema:
            type: string
            x-default: DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263
          in: query
          name: address
          required: false
          description: >-
            Token address (EVM hex, case-insensitive; Solana base58). Or send it
            as `tokenAddress`.
          example: DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263
        - schema:
            type: string
          in: query
          name: tokenAddress
          required: false
          description: 'The explicit name of `address` (the token): send one of the two.'
        - schema:
            minimum: 0
            type: integer
            x-default: 1762000000
          in: query
          name: timestamp
          required: true
          description: >-
            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.
          example: 1762000000
      responses:
        '200':
          description: Standard `{ data, meta }` envelope.
components:
  securitySchemes:
    apiKey:
      type: apiKey
      name: Authorization
      in: header
      description: Your raw API key (not needed on the demo server).

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.