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

> Static definition of one market (pool): venue/type, launchpad/factory of origin, fee tier (bps), base & quote token metadata, price, liquidity, launchpad + bonding state, created-at. Slow-changing, cache-friendly. A market id is simply chain + pool address: stable, unique on its venue, never reused.

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

Static definition of one market (pool): venue/type, the launchpad or factory it came from, fee tier, base & quote token metadata, price, liquidity, launchpad + bonding state, and created-at. Slow-changing, so cache it freely. A market id is simply chain + pool address: stable, unique on its venue, never reused.

<Note>`factory` is the launchpad/factory of origin from our registry (e.g. `CLANKER`, `ZORA`, `PUMPFUN`), or `null` for a plain AMM pool. `feeBps` is the swap fee of the market in basis points. On EVM it is the fee tier of concentrated-liquidity venues (Uniswap V3/V4, PancakeSwap V3, Aerodrome Slipstream). On Solana it is the total fee charged on the market's latest trade (LP, protocol, platform and creator shares; it moves with volatility or the launch schedule on dynamic-fee venues), e.g. `125` on a Pump.fun curve. `null` when the fee is dynamic without a readable rate, not measured yet, or the venue's fee units aren't certain, never a guess. It may carry two decimals: fee units are hundredths of a basis point (a `3499` fee tier is `34.99` bps). `bondingProgress` is `100` once the curve has migrated, consistent with the token endpoint.</Note>

<Note>`bondingProgress` (0-100) is only present while `isLaunchpad` is true; `migrated` flips true once the token graduates to its AMM pool.</Note>

<Note>`priceNative` and `liquidityNative` are `null` when the market has not traded yet. A market whose price fell to zero after trading keeps `priceNative` `"0"`.</Note>

<RequestExample>
  ```bash cURL theme={null}
  curl 'https://api.serialized.xyz/v1/pool?chain=evm:8453&address=0x0ca6485b7e9cf814a3fd09d81672b07323535b64' \
    -H 'Authorization: YOUR_API_KEY'
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "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": 30,
      "token": {
        "address": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
        "name": "Degen",
        "symbol": "DEGEN",
        "decimals": 18,
        "totalSupply": "37000000000"
      },
      "quote": {
        "address": "0x4200000000000000000000000000000000000006",
        "symbol": "WETH"
      },
      "priceNative": "0.00000053241",
      "liquidityNative": "412.882",
      "isLaunchpad": false,
      "bondingProgress": null,
      "migrated": false,
      "createdAt": 1712345678000
    },
    "meta": {
      "asOf": 1786901933078
    }
  }
  ```
</ResponseExample>


## OpenAPI

````yaml openapi.json GET /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:
    get:
      summary: Market Definition
      description: >-
        Static definition of one market (pool): pair address, venue/DEX, base &
        quote token metadata, fee tier, created-at. Slow-changing -
        cache-friendly. A market id is simply chain + pool address: stable,
        unique on its venue, never reused.
      operationId: market-definition
      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'
      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.