Coin Liquidity
Retrieve the liquidity information for a specific coin across decentralized exchanges (DEXs) and lending protocols.
Endpoint
GET /api/v1/partner/coin/liquidityRequest Parameters
coin_type
string
Yes
The unique identifier of the coin (e.g., 0x...::module::COIN).
pool_type
string
Yes
Type of liquidity pools to retrieve. Must be either dex or lending.
protocols
string
No
Comma-separated list of protocol identifiers to include (e.g. flowx-clmm,flowx-cpmm).
offset
integer
No
Number of records to skip. Default: 0.
limit
integer
No
Maximum number of records to return. Default and max: 100.
List of Supported Protocols
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
navi
Navi (Lending)
suilend
Suilend (Lending)
alphalend
Alphalend (Lending)
scallop
Scallop (Lending)
Headers
x-api-key
Yes
API key for authorization.
cURL Example
curl --location 'https://api.noodles.fi/api/v1/partner/coin/liquidity?coin_type=0x87dfe1248a1dc4ce473bd9cb2937d66cdc6c30fee63f3fe0dbb55c7a09d35dec%3A%3Aup%3A%3AUP&pool_type=dex&protocols=cetus-clmm,aftermath-cpmm&limit=10&offset=0' \
--header 'Accept-Encoding: application/json' \
--header 'x-api-key: YOUR_API_KEY'Response
Success Response Example
{
"code": 200,
"message": "OK",
"data": {
"dex_liquidity": [
{
"pool_id": "0x3b4589a67fb75a9cbbaa8e90980ae02961c24a86638649450ca4b0278d64f538",
"protocol": "aftermath-cpmm",
"coin_a": "0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI",
"coin_b": "0x87dfe1248a1dc4ce473bd9cb2937d66cdc6c30fee63f3fe0dbb55c7a09d35dec::up::UP",
"amount_a": 34015.584592142,
"amount_b": 1108644.380496,
"amount_a_usd": 110635.69,
"amount_b_usd": 442542.76,
"price_a": 3.252,
"price_b": 0.399,
"price_ab": 8.148,
"tvl_usd": 553178.44,
"fee_rate": 1
}
],
"lending_liquidity": [],
"coin_info_map": {
"0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI": {
"coin_type": "0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI",
"symbol": "SUI",
"decimals": 9,
"icon_url": "https://imagedelivery.net/cBNDGgkrsEA-b_ixIp9SkQ/sui-coin.svg/public",
"verified": true
},
"0x87dfe1248a1dc4ce473bd9cb2937d66cdc6c30fee63f3fe0dbb55c7a09d35dec::up::UP": {
"coin_type": "0x87dfe1248a1dc4ce473bd9cb2937d66cdc6c30fee63f3fe0dbb55c7a09d35dec::up::UP",
"symbol": "UP",
"decimals": 6,
"icon_url": "https://www.doubleup.fun/Diamond_Only.png",
"verified": true
}
},
"pagination": {
"offset": 0,
"limit": 10
}
}
}Response Example for Lending Pools
When pool_type=lending:
{
"code": 200,
"message": "OK",
"data": {
"dex_liquidity": [],
"lending_liquidity": [
{
"pool_id": "0x8c1fad2fe2217fe64c579809a1d855127c81afe158d4d9124f9914d17a748eb1",
"protocol": "suilend",
"coin": "0x87dfe1248a1dc4ce473bd9cb2937d66cdc6c30fee63f3fe0dbb55c7a09d35dec::up::UP",
"deposit": 1228023.407651,
"deposit_usd": 496507.33,
"borrow": 16.961583,
"borrow_usd": 6.86,
"deposit_apr": 0.0002071900957212765,
"borrow_apr": 20.000828726043544,
"utilization": 0.001381210072570573
}
],
"coin_info_map": {
"0x87dfe1248a1dc4ce473bd9cb2937d66cdc6c30fee63f3fe0dbb55c7a09d35dec::up::UP": {
"coin_type": "0x87dfe1248a1dc4ce473bd9cb2937d66cdc6c30fee63f3fe0dbb55c7a09d35dec::up::UP",
"symbol": "UP",
"decimals": 6,
"icon_url": "https://www.doubleup.fun/Diamond_Only.png",
"verified": true
}
},
"pagination": {
"offset": 0,
"limit": 10
}
}
}Response Fields
code
number
No
HTTP status code.
message
string
No
Response message.
data
object
No
Coin liquidity data object.
Data Object Fields
dex_liquidity
array
No
Array of DEX liquidity pool objects (only when pool_type=dex).
lending_liquidity
array
No
Array of lending protocol liquidity objects (only when pool_type=lending).
coin_info_map
object
No
Map of coin type to coin information. Key is the standardized coin type string.
pagination
object
No
Pagination information with offset and limit.
DEX Liquidity Pool Object
pool_id
string
Unique identifier of the liquidity pool.
protocol
string
Name of the DEX protocol (e.g., "cetus-clmm", "aftermath-cpmm").
coin_a
string
Coin type identifier for the first coin in the pair.
coin_b
string
Coin type identifier for the second coin in the pair.
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.
amount_b_usd
number
USD value of coin B amount.
price_a
number
Current price of coin A.
price_b
number
Current price of coin B.
price_ab
number
Price ratio between coin A and coin B.
tvl_usd
number
Total Value Locked in USD.
fee_rate
number
Fee rate for the pool (in percentage).
Coin Info Map Object
The coin_info_map is an object where keys are standardized coin type strings and values contain:
coin_type
string
The unique identifier of the coin.
symbol
string
The coin's symbol/ticker.
decimals
number
Number of decimal places for the coin.
icon_url
string
URL to the coin's icon image.
verified
boolean
Whether the coin is verified.
Lending Liquidity Object
pool_id
string
Unique identifier of the lending pool.
protocol
string
Name of the lending protocol (e.g., "suilend").
coin
string
Coin type identifier for the coin in the lending pool.
deposit
number
Total amount deposited in the pool.
deposit_usd
number
USD value of total deposits.
borrow
number
Total amount borrowed from the pool.
borrow_usd
number
USD value of total borrows.
deposit_apr
number
Annual Percentage Rate for deposits.
borrow_apr
number
Annual Percentage Rate for borrows.
utilization
number
Pool utilization rate (borrowed/deposited).
Last updated