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).
interval	string	Yes	Aggregation interval (e.g. 1d).
protocols	string	Yes	Comma-separated list of protocol identifiers to include (e.g. flowx-clmm,flowx-cpmm).

List of supported timeframes:

Timeframe Key	Duration
1d	1 day
1w	1 week
1M	1 month
3M	3 months
6M	6 months
1Y	1 year

List of supported intervals:

Interval Key	Duration
1d	1 day
2d	2 days
1w	1 week
2w	2 weeks

List of supported protocols:

Protocol Key	Protocol Name
fullsail-clmm	Fullsail CLMM
kriya-clmm	Kriya CLMM (V3)
aftermath-cpmm	Aftermath CPMM
cetus-dlmm	Cetus DLMM
kriya-cpmm	Kriya CPMM (V2)
ferra-clmm	Ferra CLMM
bluefin-clmm	Bluefin CLMM
deepbookv3	Deepbook V3
ferra-dlmm	Ferra DLMM
7k-cpmm	7K CPMM
bluemove-cpmm	BlueMove CPMM
momentum-clmm	Momentum CLMM
interest-cpmm	Interest CPMM
flowx-cpmm	FlowX CPMM (V2)
magma-clmm	Magma CLMM
turbos-clmm	Turbos CLMM
magma-almm	Magma ALMM
flowx-clmm	FlowX CLMM (V3)
srm-cpmm	SRM CPMM
cetus-clmm	Cetus CLMM
steamm-cpmm	STEAMM CPMM
haedal-cpmm-v2	Haedal CPMM V2
haedal-cpmm	Haedal CPMM

Headers

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

cURL Example

curl --location 'https://api.noodles.fi/api/v1/partner/market/stats?timeframe=1w&interval=1d&protocols=flowx-clmm,flowx-cpmm' \
  --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": 311629,
            "volume": 38565144.64,
            "fee": 3321.54,
            "active_wallet": 22055,
            "market_cap": 1809836.1152973785,
            "tvl": 2265229.66
        },
        {
            "protocol": "flowx-cpmm",
            "trade": 28086,
            "volume": 427089.67,
            "fee": 1281.25,
            "active_wallet": 5519,
            "market_cap": 1809836.1152973785,
            "tvl": 967409.92
        }
    ]
}

Notes

• protocols supports multiple identifiers separated by commas; the response contains one object per protocol requested.

• Timeframe and interval control the aggregation window and granularity of returned stats.

---

See also: Environment Setup