# Pool Detail Chart

## Overview

Retrieve historical pool statistics including TVL, Volume, and Fee data over a specified timeframe.

## Endpoint

```bash
GET /api/v1/partner/pool/detail-chart
```

## Query Parameters

| Field       | Type     | Required | Description                                                       |
| ----------- | -------- | -------- | ----------------------------------------------------------------- |
| `pool_id`   | `string` | **Yes**  | Unique identifier of the pool.                                    |
| `timeframe` | `string` | **Yes**  | Time range of data. Supported values: `1w`, `1M`, `1Y`.           |
| `interval`  | `string` | **Yes**  | Data grouping interval. Supported values: `1d`, `2d`, `1w`, `2w`. |

## Headers

| Header      | Required | Description                          |
| ----------- | -------- | ------------------------------------ |
| `x-api-key` | Yes      | API key for authorization.           |
| `x-chain`   | Yes      | Blockchain identifier (e.g., `sui`). |

## cURL Example

```bash
curl --location 'https://api.noodles.fi/api/v1/partner/pool/detail-chart?pool_id=your_pool_id&timeframe=1M&interval=1d' \
--header 'x-api-key: YOUR_API_KEY' \
--header 'x-chain: sui'
```

## Response

| Field     | Type     | Description                               |
| --------- | -------- | ----------------------------------------- |
| `code`    | `number` | HTTP-like status code. `200` for success. |
| `message` | `string` | Status message.                           |
| `data`    | `array`  | List of pool statistics by timestamp.     |

### Pool Statistics Object

| Field        | Type     | Description                                     |
| ------------ | -------- | ----------------------------------------------- |
| `timestamp`  | `string` | ISO 8601 formatted timestamp of the data point. |
| `tvl_usd`    | `float`  | Total Value Locked in USD at the timestamp.     |
| `volume_usd` | `float`  | Trading volume in USD during the interval.      |
| `fees_usd`   | `float`  | Fees generated in USD during the interval.      |

### Success Response Example

```json
{
  "code": 200,
  "message": "OK",
  "data": [
    {
      "timestamps": "2025-11-04T00:00:00Z",
      "tvl_usd": 8495340.575042006,
      "vol_usd": 9570817.019673236,
      "fee_usd": 23975.268313251116
    },
    {
      "timestamps": "2025-11-05T00:00:00Z",
      "tvl_usd": 8839874.692484327,
      "vol_usd": 7591210.964021315,
      "fee_usd": 19011.202600682576
    },
    {
      "timestamps": "2025-11-06T00:00:00Z",
      "tvl_usd": 8303430.033076313,
      "vol_usd": 6270078.271359523,
      "fee_usd": 15701.198815201666
    },
    {
      "timestamps": "2025-11-07T00:00:00Z",
      "tvl_usd": 9962290.223233812,
      "vol_usd": 10626344.589004718,
      "fee_usd": 26608.80766262945
    },
    {
      "timestamps": "2025-11-08T00:00:00Z",
      "tvl_usd": 10574702.20802096,
      "vol_usd": 7155891.754129149,
      "fee_usd": 17918.447261311143
    },
    {
      "timestamps": "2025-11-09T00:00:00Z",
      "tvl_usd": 10797949.052349176,
      "vol_usd": 3790159.1368762315,
      "fee_usd": 9491.626135248898
    },
    {
      "timestamps": "2025-11-10T00:00:00Z",
      "tvl_usd": 8862359.565981263,
      "vol_usd": 1262632.941504351,
      "fee_usd": 3161.7482947749468
    }
  ]
}
```

***

> **See also:** [Environment Setup](https://noodles-finance.gitbook.io/docs.noodles.fi/environment-setup/environment)
