> ## 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.

# Market Definition: batch

> Batch twin: the static definition of up to 100 markets in one call, across chains. Response in input order, one slot per market, billed per market.

`POST /v1/pool` · **1 per market credit**

Batch twin: the static definition of up to 100 `{chain, address}` markets in one call, EVM and Solana mixed freely. The response comes back `200` in input order, one slot per market: `{ data }`, exactly the body of [`GET /v1/pool`](/endpoints/market-definition) for that market, or `{ error: { code, message } }` for that market alone (unknown pool, malformed address), never `null`. One bad market never costs you the rest of the lot. Billed per market.

Definitions are slow-changing, so a lot you poll comes back from cache after the first call; the single GET and the batch share it.

<Note>A slot's `data` is exactly what `GET /v1/pool` returns for that market: venue/type, launchpad or factory of origin, `feeBps`, base and quote token metadata, `priceNative`, `liquidityNative`, launchpad and bonding state, `createdAt`; see that page for the field rules.</Note>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST 'https://api.serialized.xyz/v1/pool' \
    -H 'Authorization: YOUR_API_KEY' -H 'Content-Type: application/json' \
    -d '{"items":[{"chain":"evm:8453","address":"0x0ca6485b7e9cf814a3fd09d81672b07323535b64"},{"chain":"solana","address":"58oQChx4yWmvKdwLLZzBi4ChoCc2fqCUWBkwMihLYQo2"},{"chain":"evm:8453","address":"0x00000000000000000000000000000000deadbeef"}]}'
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "data": [
      {
        "data": {
          "chain": "evm:8453",
          "address": "0x0ca6485b7e9cf814a3fd09d81672b07323535b64",
          "type": "UNISWAP_V3",
          "factory": null,
          "launchpad": null,
          "exchange": {
            "name": "Uniswap V3",
            "logo": "https://serialized.cloud/logos/dex/uniswap.680e6da3.svg"
          },
          "feeBps": 100,
          "token": {
            "address": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
            "name": "Degen",
            "symbol": "DEGEN",
            "decimals": 18,
            "totalSupply": "36189963032.46508"
          },
          "quote": {
            "address": "0x4200000000000000000000000000000000000006",
            "symbol": "WETH"
          },
          "priceNative": "0.00000042875744501546",
          "liquidityNative": "98.708436808261",
          "isLaunchpad": false,
          "bondingProgress": null,
          "migrated": false,
          "createdAt": 1705088299000
        }
      },
      {
        "data": {
          "chain": "solana",
          "address": "58oQChx4yWmvKdwLLZzBi4ChoCc2fqCUWBkwMihLYQo2",
          "type": "RAYDIUM_AMM_V4",
          "factory": null,
          "launchpad": null,
          "exchange": {
            "name": "Raydium",
            "logo": "https://serialized.cloud/logos/dex/raydium.7e076570.webp"
          },
          "feeBps": 25,
          "token": {
            "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
            "name": "USD Coin",
            "symbol": "USDC",
            "decimals": 6,
            "totalSupply": "8003434199.826001"
          },
          "quote": {
            "address": "So11111111111111111111111111111111111111112",
            "symbol": "SOL"
          },
          "priceNative": "0.009993169860651512",
          "liquidityNative": "128982.611397012",
          "isLaunchpad": false,
          "bondingProgress": null,
          "migrated": false,
          "createdAt": 1629277935000
        }
      },
      {
        "error": {
          "code": "NOT_FOUND",
          "message": "Pool 0x00000000000000000000000000000000deadbeef on evm:8453 not found"
        }
      }
    ],
    "meta": {
      "asOf": 1789076973417
    }
  }
  ```
</ResponseExample>


## OpenAPI

````yaml openapi.json POST /v1/pool
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. 18 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/pool:
    post:
      summary: 'Market Definition: batch'
      description: >-
        Batch twin: the static definition of up to 100 markets in one call,
        across chains. Response in input order, one slot per market: `{ data }`,
        the body of the single GET for that market, or `{ error }` for that
        market alone (unknown pool, malformed address), never `null`. Billed per
        market.
      operationId: market-definition-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
                      - address
                    properties:
                      chain:
                        type: string
                      address:
                        description: Pool / market address
                        type: string
                  description: >-
                    `[{ "chain": "…", "address": "…" }]` - 1 to 100 markets
                    (pool addresses, Uniswap V4 poolIds supported), EVM and
                    Solana mixed freely.
                  example:
                    - chain: evm:8453
                      address: '0x0ca6485b7e9cf814a3fd09d81672b07323535b64'
                    - chain: solana
                      address: 58oQChx4yWmvKdwLLZzBi4ChoCc2fqCUWBkwMihLYQo2
                  x-default:
                    - chain: evm:8453
                      address: '0x0ca6485b7e9cf814a3fd09d81672b07323535b64'
                    - chain: solana
                      address: 58oQChx4yWmvKdwLLZzBi4ChoCc2fqCUWBkwMihLYQo2
      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.