Pool Liquidity
Overview
Retrieve detailed liquidity and performance data for specific DEX liquidity pools across supported protocols.
Endpoint
GET /api/v1/partner/pool/liquidity-poolsRequest Parameters
pool_addresses
string
No
Comma-separated list of pool IDs (addresses) to filter. Example: 0xfa54...a0a,0x3b45...f538.
protocols
string
No
Comma-separated list of protocols to include (e.g., magma-clmm,cetus-clmm). See full protocol list below.
coin_ids
string
No
Comma-separated list of coin types to filter pools by (e.g., 0x...::usdc::USDC).
tvl_min
number
No
Minimum TVL (USD) filter.
tvl_max
number
No
Maximum TVL (USD) filter.
coin_a_cap_min
number
No
Minimum market cap for coin A.
coin_b_cap_min
number
No
Minimum market cap for coin B.
coin_a_fdv_min
number
No
Minimum FDV for coin A.
coin_b_fdv_min
number
No
Minimum FDV for coin B.
coin_a_cap_max
number
No
Maximum market cap for coin A.
coin_b_cap_max
number
No
Maximum market cap for coin B.
coin_a_fdv_max
number
No
Maximum FDV for coin A.
coin_b_fdv_max
number
No
Maximum FDV for coin B.
strict_coin_cap_fdv
boolean
No
If true, both coins must satisfy market cap/FDV filters.
sort_field
string
No
Field to sort results by (e.g., tvl_usd, apr_24h, apr_1w, volume_24h, volume_1w, total_apr_24h, total_apr_1w, fee_24h, fee_1w, created_at, ).
sort_direction
string
No
Sort order: ASC or DESC.
category_group
string
No
Group filter (e.g., meme, stablecoin, other).
pool_type
string
No
Pool type filter (e.g., clmm, cpmm, dlmm, weighted, stableswap, oracle).
limit
integer
No
Number of results to return (default: 20, max: 20).
offset
integer
No
Offset for pagination (default: 0).
List of supported protocols:
aftermath-cpmm
Aftermath CPMM
aftermath-metastable
Aftermath Metastable
bluefin-clmm
Bluefin CLMM
bluemove-cpmm
BlueMove CPMM
cetus-clmm
Cetus CLMM
cetus-dlmm
Cetus DLMM
ferra-clmm
Ferra CLMM
ferra-dlmm
Ferra DLMM
flowx-clmm
FlowX CLMM (V3)
flowx-cpmm
FlowX CPMM (V2)
fullsail-clmm
Fullsail CLMM
haedal-cpmm
Haedal CPMM
haedal-cpmm-v2
Haedal CPMM V2
interest-cpmm
Interest CPMM
kriya-clmm
Kriya CLMM (V3)
kriya-cpmm
Kriya CPMM (V2)
magma-clmm
Magma CLMM
magma-almm
Magma ALMM
momentum-clmm
Momentum CLMM
7k-cpmm
7K CPMM
steamm-cpmm
STEAMM CPMM
srm-cpmm
SRM CPMM
turbos-clmm
Turbos CLMM
tradeport-clmm
Tradeport CLMM
Headers
x-api-key
Yes
API key for authentication.
cURL Example
curl --location 'https://api.noodles.fi/api/v1/partner/pool/liquidity-pools?pool_addresses=0xfa54f1de53af9135aea64d31e8e4b543fc0b073a6c218f520f5b015d28951a0a&protocols=magma-clmm&coin_ids=0x549e8b69270defbfafd4f94e17ec44cdbdd99820b33bda2278dea3b9a32d3f55::cert::CERT&tvl_min=100&sort_direction=desc&coin_a_cap_min=10000000&coin_b_cap_min=10000000&coin_a_fdv_min=100&coin_b_fdv_min=100&coin_a_cap_max=1000000000000&coin_b_cap_max=1000000000000&coin_a_fdv_max=1000000000000&coin_b_fdv_max=1000000000000&strict_coin_cap_fdv=false&sort_field=volume_24h&sort_direction=DESC&category_group=other&pool_type=clmm' \
--header 'x-api-key: YOUR_API_KEY'Response
code
number
No
HTTP status code.
message
string
No
Response message.
data
array
No
Array of liquidity pool objects.
Liquidity Pool Object
pool_id
string
Unique identifier of the pool.
protocol
string
Protocol key (e.g., magma-clmm, cetus-clmm).
coin_a
object
Details of coin A in the pool.
coin_b
object
Details of coin B in the pool.
amount_a
number
Amount of coin A in the pool.
amount_b
number
Amount of coin B in the pool.
amount_a_usd
number
USD value of coin A.
amount_b_usd
number
USD value of coin B.
price_a
number
Price of coin A.
price_b
number
Price of coin B.
price_ab
number
Price ratio between A and B.
tvl_usd
number
Total value locked (USD).
tvl_usd_24h_change
number
24-hour change in TVL (%).
fee_rate
number
Pool fee rate (in %).
fee_24h
number
Total fees generated in last 24h (USD).
fee_1w
number
Total fees generated in last 7 days (USD).
fee_24h_change
number
24-hour fee change (%).
volume_24h
number
Trading volume in last 24h (USD).
volume_24h_change
number
24-hour volume change (%).
volume_1w
number
Weekly trading volume (USD).
fee_apr_24h
number
Estimated 24h APR from fees.
fee_apr_1w
number
Estimated 7d APR from fees.
rewards
array
List of reward emission coins (see below).
active
boolean
Whether the pool is active.
created_at
string
Pool creation timestamp (ISO 8601).
pool_type
string
Type of pool (e.g., clmm, cpmm, dlmm).
Reward Object
coin_type
string
Coin identifier for reward token.
symbol
string
Token symbol.
decimals
number
Number of decimal places.
icon_url
string
Token icon URL.
verified
boolean
Whether the token is verified.
daily_amount
number
Number of tokens distributed daily.
daily_amount_usd
number
USD value of daily reward.
apr
number
APR contribution from rewards (%).
Coin Object (within pools)
coin_type
string
Unique identifier of the coin.
symbol
string
Symbol or ticker of the coin.
decimals
number
Decimal precision.
icon_url
string
Icon URL.
verified
boolean
Whether the coin is verified.
category
string
Category of the coin (e.g., "Infrastructure", "Liquid Staking").
Success Response Example
{
"code": 200,
"message": "OK",
"data": [
{
"pool_id": "0xfa54f1de53af9135aea64d31e8e4b543fc0b073a6c218f520f5b015d28951a0a",
"protocol": "magma-clmm",
"coin_a": {
"coin_type": "0x549e8b69270defbfafd4f94e17ec44cdbdd99820b33bda2278dea3b9a32d3f55::cert::CERT",
"symbol": "vSUI",
"decimals": 9,
"icon_url": "https://imagedelivery.net/cBNDGgkrsEA-b_ixIp9SkQ/vSUI.png/public",
"verified": true,
"category": "Liquid Staking"
},
"coin_b": {
"coin_type": "0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI",
"symbol": "SUI",
"decimals": 9,
"icon_url": "https://imagedelivery.net/cBNDGgkrsEA-b_ixIp9SkQ/sui-coin.svg/public",
"verified": true,
"category": "Infrastructure"
},
"amount_a": 232345.284413853,
"amount_b": 3408282.85767515,
"amount_a_usd": 531542.8,
"amount_b_usd": 7391202.21,
"price_a": 2.288,
"price_b": 2.169,
"price_ab": 1.055,
"tvl_usd": 7922745.01,
"tvl_usd_24h_change": 0,
"fee_rate": 0.01,
"fee_24h": 7.74,
"fee_24h_change": 0,
"fee_1w": 75.98,
"fee_a_24h": {
"fee_raw": 0.15650959,
"fee_usd": 0.35
},
"fee_b_24h": {
"fee_raw": 3.54402782,
"fee_usd": 7.39
},
"fee_a_1w": {
"fee_raw": 6.27958943,
"fee_usd": 13.78
},
"fee_b_1w": {
"fee_raw": 30.142331406,
"fee_usd": 62.2
},
"volume_24h": 8495829.24,
"volume_24h_change": -19.97,
"volume_1w": 88408030.4,
"fee_apr_24h": 0.04,
"fee_apr_1w": 0.05,
"rewards": [
{
"coin_type": "0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI",
"symbol": "SUI",
"decimals": 9,
"icon_url": "https://imagedelivery.net/cBNDGgkrsEA-b_ixIp9SkQ/sui-coin.svg/public",
"verified": true,
"daily_amount": 192.642857142,
"daily_amount_usd": 416.84,
"apr": 1.92
}
],
"active": true,
"created_at": "2025-03-01T06:46:01.901Z",
"pool_type": "clmm"
}
]
}See also: Environment Setup
Last updated