Coin By Protocol

Retrieve a list of coins associated with one or more specified protocols. This endpoint returns token metadata, market data, and short-term price changes for coins that belong to the given protocols.

Endpoint

GET /api/v1/partner/coin/by-protocol

Parameters

Request Parameters

Name	Type	Required	Description
protocols	string	Yes	Comma-separated list of protocol identifiers (e.g., flowx-clmm,flowx-cpmm).
limit	number	No	Maximum number of records to return. Default: 20.
offset	number	No	Number of records to skip before starting to return results. Default: 0.
sort_field	string	No	Field to sort by: volume_24h or liquidity_usd. Default: volume_24h.
sort_direction	string	No	Sorting order: ASC or DESC. Default: DESC.

List of Supported Protocols

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

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/coin/by-protocol?protocols=flowx-clmm,flowx-cpmm&limit=20&offset=0&sort_field=volume_24h&sort_direction=DESC' \
--header 'Accept-Encoding: application/json' \
--header 'x-api-key: YOUR_API_KEY' \
--header 'x-chain: sui'

Response

Fields

Field	Type	Nullable	Description
code	number	No	HTTP status code.
message	string	No	Response message.
data	array	No	List of coin objects.

Coin Object

Field	Type	Nullable	Description
coin_type	string	No	Unique identifier of the coin.
name	string	No	Full name of the coin.
symbol	string	No	Token symbol.
logo	string	Yes	URL to the token’s logo image.
volume_24h	string	Yes	24-hour trading volume in USD.
liquidity_usd	string	Yes	Current liquidity in USD.
price	number	Yes	Current price in USD.
price_change_1h	number	Yes	% price change in the last 1 hour.
price_change_6h	number	Yes	% price change in the last 6 hours.
price_change_1d	number	Yes	% price change in the last 24 hours.

Success Response Example

{
    "code": 200,
    "message": "OK",
    "data": [
        {
            "coin_type": "0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC",
            "name": "USDC",
            "symbol": "USDC",
            "logo": "https://imagedelivery.net/cBNDGgkrsEA-b_ixIp9SkQ/usdc.png/public",
            "volume_24h": "1440584.09",
            "liquidity_usd": "1130892.44",
            "price": 0.9983838000208395,
            "price_change_1h": -0.14,
            "price_change_6h": -0.26,
            "price_change_1d": -0.17
        },
        {
            "coin_type": "0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI",
            "name": "Sui",
            "symbol": "SUI",
            "logo": "https://imagedelivery.net/cBNDGgkrsEA-b_ixIp9SkQ/sui-coin.svg/public",
            "volume_24h": "1285661.56",
            "liquidity_usd": "762858.27",
            "price": 2.1654,
            "price_change_1h": -0.79,
            "price_change_6h": 0.07,
            "price_change_1d": 3.01
        }
    ]
}

Notes

• The endpoint aggregates coins based on their participation in the specified protocols (e.g., CLMM or CPMM pools).

• Sorting can be customized to rank coins by trading volume, liquidity, or recent performance.

• This endpoint is ideal for fetching trending or high-volume assets within specific DEX protocols.

---

See also: Environment Setup