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

# Pool Price

> Cheap price tier of one pool: its price, the market cap at that price and the pool's own liquidity, the figures of /v1/pool/data. Nothing else.

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

Cheap price tier of one pool, for bots and tickers: its price, the market cap at that price and the pool's own liquidity, the figures of [`/v1/pool/data`](https://docs.serialized.xyz/endpoints/pool-data) without the windowed stats. It is the pool twin of [Token Price](https://docs.serialized.xyz/endpoints/token-price-lean.md).

> [!NOTE]
>
> `poolAddress` is the pool you asked for; `tokenAddress` is the token it prices. On input, `poolAddress` can be sent instead of `address`.

> [!NOTE]
>
> On the token's [main market](https://docs.serialized.xyz/conventions.md#the-main-market), the `poolAddress` of [Token Price](https://docs.serialized.xyz/endpoints/token-price-lean.md), `priceNative`, `priceUsd` and `marketCapUsd` are the figures of Token Price, except for native coins and their wrapped forms, which Token Price prices at `"1"` by construction. A price that fails our sanity checks is `null` on both. `liquidityUsd` differs: here it is the liquidity of this pool alone, on Token Price the token's liquidity, its most traded markets summed.

> [!NOTE]
>
> `priceNative`, `priceUsd`, `marketCapUsd` and `liquidityUsd` are `null` while the pool has not traded yet. A pool whose price fell to zero after trading keeps `priceNative``"0"`. On Solana, a pool with no visible reserve (an order book, a proprietary AMM) has a `liquidityUsd` of `null`.

> [!NOTE]
>
> `marketCapUsd` is the token's circulating supply × this pool's price, the rule of [`/v1/pool/data`](https://docs.serialized.xyz/endpoints/pool-data): the asset's circulating supply for majors, stablecoins and native coins, the total supply minus the tokens held by burn addresses for every other token (`null` while that amount is not known).

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

```json Response theme={null}
{
  "data": {
    "chain": "evm:8453",
    "tokenAddress": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
    "poolAddress": "0x0ca6485b7e9cf814a3fd09d81672b07323535b64",
    "priceNative": "0.00000053241",
    "priceUsd": 0.001001,
    "marketCapUsd": 37037000,
    "liquidityUsd": 776218.24
  },
  "meta": {
    "asOf": 1786724320112
  }
}
```


## OpenAPI

````yaml openapi.json GET /v1/pool/price
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/price:
    get:
      summary: Pool Price
      description: >-
        Cheap price tier of one pool: its price, the market cap at that price
        and the pool's own liquidity, the figures of /v1/pool/data. Nothing
        else.
      operationId: pool-price
      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: false
          description: >-
            Pool / pair address (the stable market id on its chain). Or send it
            as `poolAddress`.
          example: '0x0ca6485b7e9cf814a3fd09d81672b07323535b64'
        - schema:
            type: string
          in: query
          name: poolAddress
          required: false
          description: 'The explicit name of `address` (the pool): send one of the two.'
      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.