Market Stats

Overview

Get aggregated market statistics for one or more protocols over a specified timeframe and interval.

Endpoint

GET /api/v1/partner/market/stats

Query Parameters

Parameter	Type	Required	Description
timeframe	string	Yes	Time window for aggregation (e.g. 1d).
protocols	string	No	Comma-separated list of protocol identifiers to include (e.g. flowx-clmm,flowx-cpmm). If not provided, returns stats for all protocols.

List of supported timeframes:

Timeframe Key	Duration
1d	1 day
1w	1 week

List of supported protocols:

See Market Supported Protocol for the complete list of protocol identifiers and their names.

Headers

Header	Required	Description
x-api-key	No	API key for authentication (if required).

cURL Examples

Get Stats for Specific Protocols

curl --location 'https://api.noodles.fi/api/v1/partner/market/stats?timeframe=1w&protocols=flowx-clmm,flowx-cpmm' \
  --header 'Accept: application/json' \
  --header 'x-api-key: YOUR_API_KEY'

Get Stats for All Protocols

curl --location 'https://api.noodles.fi/api/v1/partner/market/stats?timeframe=1w' \
  --header 'Accept: application/json' \
  --header 'x-api-key: YOUR_API_KEY'

Response

Fields

Field	Type	Description
code	number	HTTP-like response code (200 = success).
message	string	Human-readable status message.
data	array	Array of protocol statistics objects.

Protocol statistics object:

Field	Type	Description
protocol	string	Protocol identifier.
trade	integer	Number of trades in the selected timeframe.
volume	number	Traded volume (USD) in the selected timeframe.
fee	number	Fees collected (USD) in the selected timeframe.
active_wallet	integer	Count of unique active wallets.
market_cap	number	Market capitalization (USD).
tvl	number	Total value locked (USD).

Success Response

{
    "code": 200,
    "message": "OK",
    "data": [
        {
            "protocol": "flowx-clmm",
            "trade": 35877,
            "volume": 8436971.423051924,
            "fee": 177.13389906195562,
            "tvl": 3352421.793046631
        },
        {
            "protocol": "flowx-cpmm",
            "trade": 3131,
            "volume": 27044.38049921295,
            "fee": 84.12411452460161,
            "tvl": 587171.3803198142
        }
    ]
}

---

See also: Environment Setup