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, liquidity_usd, price_change_1h, price_change_6h, or price_change_1d. Default: volume_24h.
sort_direction	string	No	Sorting order: ASC or DESC. Default: DESC.

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	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