Pool Detail Chart

Overview

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

Endpoint

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

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

{
  "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