> ## 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: batch

> Batch twin - up to 100 tokens in one call, each with its own `timestamp`, chains mixed. Response in input order; a token with no trade yet at its instant comes back as a `NO_PRICE_AT` `{error}` slot.

`POST /v1/token/price-at` · **1 credit per 25 items**

Batch twin - up to 100 tokens in one call, each with its own `timestamp` (unix seconds), chains mixed. The tokens of a chain are read in one pass. Response in input order; a token with no trade yet at its instant comes back as a `NO_PRICE_AT` `{error}` slot, an unknown token as `NOT_FOUND`; error slots are not billed.

> [!NOTE]
>
> Each slot is the body of [Token Price at a date](https://docs.serialized.xyz/endpoints/token-price-at.md): `at` is the second of the trade served, at or before the item's `timestamp`, `poolAddress` the market that served it. Each item takes `address` or its other name, `tokenAddress`. The same token can appear several times with different instants.

```bash cURL theme={null}
curl -X POST 'https://api.serialized.xyz/v1/token/price-at' \
  -H 'Authorization: YOUR_API_KEY' -H 'Content-Type: application/json' \
  -d '{"items": [{"chain": "solana", "address": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263", "timestamp": 1762000000}, {"chain": "solana", "address": "GXS1XuYuZJX7NuQvXPJPbpe4YfTsm3UyK4AmqsMcpump", "timestamp": 1793812000}]}'
```

```json Response theme={null}
{
  "data": [
    {
      "data": {
        "chain": "solana",
        "address": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
        "tokenAddress": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
        "poolAddress": "5zpyutJu9ee6jFymDGoK7F6S5Kczqtc9FomP3ueKuyA9",
        "timestamp": 1762000000,
        "at": 1761999972,
        "priceNative": "0.00000007642689693668835",
        "priceUsd": 0.000014244780554807382,
        "usdBasis": "trade"
      }
    },
    {
      "error": {
        "code": "NO_PRICE_AT",
        "message": "No trade at or before 1793812000 on the main market of GXS1XuYuZJX7NuQvXPJPbpe4YfTsm3UyK4AmqsMcpump on solana"
      }
    }
  ],
  "meta": {
    "asOf": 1794060000000
  }
}
```


## OpenAPI

````yaml openapi.json POST /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:
    post:
      summary: 'Token Price at a date: batch'
      description: >-
        Batch twin - up to 100 tokens in one call, each with its own
        `timestamp`, chains mixed, read in one grouped pass per chain. Response
        in input order; a token with no trade yet at its instant comes back as a
        `NO_PRICE_AT` `{error}` slot. Billed as one call per 25 items served: up
        to 25 items cost 1 credit, 26 to 50 cost 2 credits, and so on.
      operationId: token-price-at-batch
      requestBody:
        required: true
        content:
          application/json:
            schema:
              additionalProperties: false
              type: object
              required:
                - items
              properties:
                items:
                  minItems: 1
                  maxItems: 100
                  type: array
                  items:
                    additionalProperties: false
                    type: object
                    required:
                      - chain
                      - timestamp
                    properties:
                      chain:
                        type: string
                      address:
                        description: Token address (or tokenAddress)
                        type: string
                      tokenAddress:
                        description: >-
                          Token address: the explicit name of address, either
                          one
                        type: string
                      timestamp:
                        minimum: 0
                        description: >-
                          Unix seconds: the price is the last trade at or before
                          this instant, never after it. At most 1 day ahead.
                        type: integer
                  description: >-
                    [{chain, address, timestamp}] - max 100. Each item takes
                    `address` or its other name, `tokenAddress`, and its own
                    `timestamp` (unix seconds).
      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.