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

# Get Token Price Snapshot (batch)

> Retrieve historical token prices for multiple tokens at specific timestamps in a single request.

<Info>
  **Max 100 items per request.** Each item requires its own `timestamp`.
</Info>

### Request Body

Send an array of items or an object with an `items` array:

```json theme={null}
{
  "items": [
    { "address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", "blockchain": "ethereum", "timestamp": 1700000000 },
    { "address": "So11111111111111111111111111111111111111112", "blockchain": "solana", "timestamp": 1700000000 }
  ]
}
```

### Response Format

Returns a `payload` array matching the input order. Each entry contains:

| Field           | Type     | Description                                   |
| --------------- | -------- | --------------------------------------------- |
| `priceUSD`      | `number` | Token price in USD at the closest swap        |
| `timestamp`     | `number` | The requested timestamp                       |
| `swapTimestamp` | `number` | Actual swap timestamp (ms) used for the price |
| `poolAddress`   | `string` | Pool address where the swap was found         |

If a token is not found, the entry will contain `{ "error": "..." }`.

### Example Response

```json theme={null}
{
  "payload": [
    {
      "priceUSD": 2012.66,
      "timestamp": 1700000000,
      "swapTimestamp": 1699999997000,
      "poolAddress": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640"
    },
    {
      "priceUSD": 85.74,
      "timestamp": 1700000000,
      "swapTimestamp": 1699999999000,
      "poolAddress": "3nMFwZXwY1s1M5s8vYAHqd4wGs4iSxXE4LRoUMMYqEgF"
    }
  ]
}
```


## OpenAPI

````yaml post /2/token/price-at
openapi: 3.0.0
info:
  version: 1.0.0
  title: Mobula API
  description: >-
    Documentation of the Mobula API


    **Demo API**: The default server (demo-api.mobula.io) is a demo API with
    rate limits.

    For production use, please use api.mobula.io with an API key from
    https://admin.mobula.io
servers:
  - url: https://demo-api.mobula.io/api/
    description: Demo API (rate limited, for testing only)
  - url: https://api.mobula.io/api/
    description: Production API (requires API key)
security: []
tags:
  - name: V2 - Token
    description: Token details, price, security, ATH, and holder data
  - name: V2 - Market Data
    description: Market details, OHLCV history, and lighthouse metrics
  - name: V2 - Trades
    description: Token trades, enriched trades, and trade filters
  - name: V2 - Wallet
    description: Wallet positions, activity, trades, analysis, and labels
  - name: V2 - Assets
    description: Cross-chain asset details and price history
  - name: V2 - Swap
    description: Swap quoting and execution
  - name: V2 - Perps
    description: Perpetual futures quoting, execution, and positions
  - name: V2 - Bridge
    description: Cross-chain bridge quoting and intent status (Alpha Preview)
  - name: V2 - DeFi
    description: Bonding pools and pulse data
  - name: V2 - Search
    description: Universal fast search
  - name: V2 - Blockchains
    description: System metadata and chain listings
  - name: V1 - Market Data
    description: Market prices, history, sparklines, pairs, and multi-data
  - name: V1 - Wallet
    description: Wallet portfolio, transactions, history, and NFTs
  - name: V1 - Token
    description: First buyers
  - name: V1 - Trades
    description: Market trades by pair
  - name: V1 - Metadata
    description: Token metadata, categories, trendings, and news
  - name: V1 - Assets
    description: List all assets
  - name: V1 - Search
    description: Search for assets, tokens, and pairs
  - name: V1 - DeFi
    description: Bonding pool pulse data
  - name: V1 - Blockchains
    description: Blockchain listings, pairs, and stats
  - name: V1 - Webhooks
    description: Webhook management
  - name: V1 - Feed
    description: Custom feed creation
paths:
  /2/token/price-at:
    post:
      tags:
        - V2 - Token
      summary: Get Token Price Snapshot (batch)
      description: >-
        Get historical prices for multiple tokens at specific timestamps in a
        single batch. Each item requires a `timestamp` (unix seconds). Max 100
        items per request.
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
                - type: array
                  items:
                    type: object
                    properties:
                      chainId:
                        type: string
                      blockchain:
                        type: string
                      address:
                        type: string
                      timestamp:
                        type: integer
                        minimum: 0
                        exclusiveMinimum: true
                    required:
                      - timestamp
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        type: object
                        properties:
                          chainId:
                            type: string
                          blockchain:
                            type: string
                          address:
                            type: string
                          timestamp:
                            type: integer
                            minimum: 0
                            exclusiveMinimum: true
                        required:
                          - timestamp
                  required:
                    - items
      responses:
        '200':
          description: Token price-at batch response
          content:
            application/json:
              schema:
                type: object
                properties:
                  payload:
                    type: array
                    items:
                      anyOf:
                        - type: object
                          properties:
                            name:
                              type: string
                              nullable: true
                            symbol:
                              type: string
                              nullable: true
                            logo:
                              type: string
                              nullable: true
                            priceUSD:
                              type: number
                            marketCapUSD:
                              type: number
                              nullable: true
                            marketCapDilutedUSD:
                              type: number
                              nullable: true
                            timestamp:
                              type: number
                            swapTimestamp:
                              type: number
                            poolAddress:
                              type: string
                          required:
                            - name
                            - symbol
                            - logo
                            - priceUSD
                            - marketCapUSD
                            - marketCapDilutedUSD
                            - timestamp
                            - swapTimestamp
                            - poolAddress
                        - type: object
                          properties:
                            error:
                              type: string
                        - nullable: true
                required:
                  - payload

````