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

> Live snapshot of one market, safe to poll at high frequency: price (native + USD), liquidity, market cap, circulating + total supply, and per-window volume, buy/sell counts and volumes, unique traders, fees and price change (5m / 1h / 6h / 24h). One call per market poll.

`GET /v1/pool/data` · **1 credit**

Live snapshot of one market, safe to poll at high frequency: price (native + USD), liquidity, market cap, circulating + total supply, and per-window stats - volume, buy/sell counts and volumes, unique traders, fees and price change. Windowed stats come from the same engine as [Token Stats](/endpoints/token-stats-windowed), scoped to this pool. The full security fields (authorities, taxes, concentration) live on [Token Security](/endpoints/token-security).

<Note>Each window carries `volumeNative`/`volumeUsd`, `buys`/`sells`, `buyVolumeNative`/`sellVolumeNative`, `txns` (distinct transactions), `traders` (unique wallets), `uniqueBuyers`/`uniqueSellers` (unique wallets that bought / sold in the window), `feesNative` and `priceChangePct`. `feesNative` is the total fees paid by the traders of the window (gas and priority fees, plus validator tips on Solana), in the chain's native unit. Solana markets additionally carry organic-volume twins and `poolFeesNative`, the fees collected by the pool itself (LP, protocol and creator fees).</Note>

<Note>`priceChangePct` is the price change of this market over the window, in percent. `null` when the window carries no priced trades.</Note>

<Note>`priceNative`, `priceUsd`, `marketCapUsd`, `liquidityNative` and `liquidityUsd` are `null` when the market has not traded yet; the windows then report measured zeros.</Note>

<Note>Without `windows`, all four windows (`5m`, `1h`, `6h`, `24h`) are served: the same default as Token Stats.</Note>

<RequestExample>
  ```bash cURL theme={null}
  curl 'https://api.serialized.xyz/v1/pool/data?chain=evm:8453&address=0x0ca6485b7e9cf814a3fd09d81672b07323535b64&windows=5m,1h,6h,24h' \
    -H 'Authorization: YOUR_API_KEY'
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "data": {
      "chain": "evm:8453",
      "address": "0x0ca6485b7e9cf814a3fd09d81672b07323535b64",
      "type": "UNISWAP_V3",
      "launchpad": null,
      "exchange": {
        "name": "Uniswap V3",
        "logo": "https://serialized.cloud/logos/dex/uniswap.680e6da3.svg"
      },
      "token": {
        "address": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
        "name": "Degen",
        "symbol": "DEGEN",
        "decimals": 18,
        "totalSupply": "37000000000"
      },
      "quote": {
        "address": "0x4200000000000000000000000000000000000006",
        "symbol": "WETH"
      },
      "priceNative": "0.00000053241",
      "priceUsd": 0.001001,
      "liquidityNative": "412.882",
      "liquidityUsd": 776218.24,
      "marketCapUsd": 37037000,
      "circulatingSupply": "18500000000",
      "bondingProgress": null,
      "migrated": false,
      "stats": {
        "5m": {
          "volumeNative": 0.041233,
          "volumeUsd": 77.51,
          "buys": 3,
          "sells": 1,
          "txns": 4,
          "buyVolumeNative": 0.038104,
          "sellVolumeNative": 0.003129,
          "traders": 4,
          "feesNative": 0.000123,
          "priceChangePct": 0.42
        },
        "1h": {
          "volumeNative": 1.204518,
          "volumeUsd": 2264.49,
          "buys": 41,
          "sells": 27,
          "txns": 66,
          "buyVolumeNative": 0.812337,
          "sellVolumeNative": 0.392181,
          "traders": 52,
          "feesNative": 0.003613,
          "priceChangePct": 1.87
        },
        "24h": {
          "volumeNative": 9.021983,
          "volumeUsd": 16961.28,
          "buys": 512,
          "sells": 388,
          "txns": 881,
          "buyVolumeNative": 5.118442,
          "sellVolumeNative": 3.903541,
          "traders": 641,
          "feesNative": 0.027065,
          "priceChangePct": 4.96
        }
      }
    },
    "meta": {
      "asOf": 1786901933078
    }
  }
  ```
</ResponseExample>


## OpenAPI

````yaml openapi.json GET /v1/pool/data
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/data:
    get:
      summary: Market Data
      description: >-
        Live snapshot of one market, safe to poll at high frequency: last price,
        per-window volume, liquidity, market cap, circulating + total supply,
        buys/sells and unique traders per window (5m/1h/6h/24h). Buy/sell tax
        and the full security fields live on `/v1/token/security`.
      operationId: market-data
      parameters:
        - schema:
            type: string
            x-default: evm:8453
          in: query
          name: chain
          required: true
          description: Public chain id - `evm:<id>` or `solana`.
          example: evm:8453
        - schema:
            type: string
            x-default: '0x0ca6485b7e9cf814a3fd09d81672b07323535b64'
          in: query
          name: address
          required: true
          description: >-
            Pool / pair address (the stable market id on its chain - Uniswap V4
            poolIds supported).
          example: '0x0ca6485b7e9cf814a3fd09d81672b07323535b64'
        - schema:
            default: 5m,1h,6h,24h
            type: string
            x-default: 5m,1h,6h,24h
          in: query
          name: windows
          required: false
          description: >-
            Comma-separated stat windows among `5m`, `1h`, `4h`, `6h`, `24h`.
            Default: `5m,1h,6h,24h`, the same default as `/v1/token/stats`.
          example: 5m,1h,6h,24h
      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.