Coin List

Retrieve a paginated list of coins with customizable sorting and filtering options. This API provides comprehensive coin data with flexible query parameters for various use cases.

Endpoint

POST /api/v1/partner/coin-list

Request Body

Parameters

Field	Type	Required	Description
pagination	object	No	Pagination settings
├─ limit	number	No	Max number of items to return. Default: 20, Max: 200.
└─ offset	number	No	Index to start the results from. Default: 0.
sort_by	string	No	Sort field. Default: VOLUME_1D. See Sort By Options.
order	string	No	Sort order: ASC or DESC. Default: DESC.
filters	object	No	Filter criteria
├─ coin_ids	string[]	No	Array of coin_id to filter (use to filter favorite coins).
├─ min_market_cap	number	No	Minimum market cap filter.
├─ max_market_cap	number	No	Maximum market cap filter.
├─ min_liquidity	number	No	Minimum liquidity (USD) filter.
├─ max_liquidity	number	No	Maximum liquidity (USD) filter.
├─ min_volume	number	No	Minimum 24h volume filter.
├─ max_volume	number	No	Maximum 24h volume filter.
├─ min_top_10_holding	number	No	Minimum top 10 holders percentage (0-100).
├─ max_top_10_holding	number	No	Maximum top 10 holders percentage (0-100).
├─ min_holder	number	No	Minimum number of holders.
├─ max_holder	number	No	Maximum number of holders.
├─ min_price_1h_change	number	No	Minimum 1h price change percentage.
├─ max_price_1h_change	number	No	Maximum 1h price change percentage.
├─ min_price_6h_change	number	No	Minimum 6h price change percentage.
├─ max_price_6h_change	number	No	Maximum 6h price change percentage.
├─ min_price_24h_change	number	No	Minimum 24h price change percentage.
├─ max_price_24h_change	number	No	Maximum 24h price change percentage.
├─ min_tx_buy_24h	number	No	Minimum buy transactions in 24h.
├─ max_tx_buy_24h	number	No	Maximum buy transactions in 24h.
├─ min_tx_sell_24h	number	No	Minimum sell transactions in 24h.
├─ max_tx_sell_24h	number	No	Maximum sell transactions in 24h.
├─ min_tx_24h	number	No	Minimum total transactions in 24h.
├─ max_tx_24h	number	No	Maximum total transactions in 24h.
├─ publish_at_from	string	No	Filter coins published from this date (ISO 8601 format).
├─ publish_at_to	string	No	Filter coins published until this date (ISO 8601 format).
├─ has_x_social	boolean	No	Filter coins with X/Twitter social link.
├─ has_telegram_social	boolean	No	Filter coins with Telegram social link.
├─ has_discord_social	boolean	No	Filter coins with Discord social link.
├─ has_website_social	boolean	No	Filter coins with website link.
├─ has_social	boolean	No	Filter coins with any social links.
├─ verified	boolean	No	Filter by verification status.
└─ is_boosted	boolean	No	Filter boosted coins.

Sort By Options

Value	Description
VOLUME_1D	Sort by 24-hour trading volume (default)
MARKETCAP	Sort by market capitalization
LIQUIDITY	Sort by liquidity in USD
TX_COUNT	Sort by transaction count (24h)
PRICE_CHANGE_1H	Sort by 1-hour price change
PRICE_CHANGE_4H	Sort by 4-hour price change
PRICE_CHANGE_6H	Sort by 6-hour price change
PRICE_CHANGE_1D	Sort by 24-hour price change
PUBLISHED_AT	Sort by coin publish date

Example Request

curl --location 'https://api.noodles.fi/api/v1/partner/coin-list' \
--header 'Accept-Encoding: application/json' \
--header 'x-api-key: <YOUR-API-KEY>' \
--header 'Content-Type: application/json' \
--data '{
    "pagination": {
        "offset": 0,
        "limit": 2
    },
    "sort_by": "PRICE_CHANGE_1H",
    "order": "DESC",
    "filters": {
        "min_liquidity": 1000,
        "min_price_1h_change": 10
    }
}'

Headers

Header	Required	Description
x-api-key	No	API key for authentication.

Response Body

Fields

Field	Type	Description
data	array	List of coin objects.
├─ coin_type	string	Coin Identifier
├─ name	string	Name of the coin.
├─ symbol	string	Symbol of the coin.
├─ logo	string	URL to the coin's logo.
├─ price	number	Current price of the coin.
├─ price_change_1h	number	% price change in the last hour.
├─ price_change_6h	number	% price change in the last 6 hours.
├─ price_change_1d	number	% price change in the last 24 hours.
├─ vol_change_1d	number	% volume change in the last 24 hours.
├─ liq_change_1d	number	% liquidity of coin (usd) change in the last 24 hours.
├─ tx_change_1d	number	% Number of transactions change in the last 24 hours.
├─ tx_24h	number	Number of transactions in 24h.
├─ volume_24h	number	Trading volume in 24h.
├─ volume_6h	number	Trading volume in 6h.
├─ volume_4h	number	Trading volume in 4h.
├─ volume_1h	number	Trading volume in 1h.
├─ volume_30m	number	Trading volume in 30 minutes.
├─ maker_24h	number	Number of makers in 24h.
├─ market_cap	string	Market cap.
├─ liquidity_usd	string	Liquidity in USD.
├─ circulating_supply	string	Circulating supply.
├─ total_supply	string	Total coin supply.
├─ published_at	string	Created time of the coin (RFC3339 format).
├─ verified	boolean	Indicates if the coin is verified by Blockvision.
└─ decimals	number	Number of decimals for the coin.
pagination	object	Pagination object (limit & offset).

Success Response

{
    "code": 200,
    "message": "success",
    "data": [
        {
            "coin_type": "0xdeeb7a4662eec9f2f3def03fb937a663dddaa2e215b8078a284d026b7946c270::deep::DEEP",
            "name": "DeepBook Token",
            "symbol": "DEEP",
            "logo": "https://imagedelivery.net/cBNDGgkrsEA-b_ixIp9SkQ/DEEP_BlueBackground.png/public",
            "price": 0.0947,
            "price_change_1h": 0.08,
            "price_change_6h": 6.31,
            "price_change_1d": 6.24,
            "vol_change_1d": -47.62,
            "liq_change_1d": 47.49,
            "tx_change_1d": -40.16,
            "tx_24h": 79491,
            "volume_24h": 32805870,
            "volume_6h": 2836299.83,
            "volume_4h": 2287841.14,
            "volume_1h": 368241.21,
            "volume_30m": 235308.84,
            "maker_24h": 10524,
            "market_cap": "236635701",
            "liquidity_usd": "4310216",
            "circulating_supply": "2500000000",
            "total_supply": "9992870898",
            "published_at": "2024-03-28T13:18:43.56Z",
            "verified": true,
            "decimals": 9
        },
        {
            "coin_type": "0x32a976482bf4154961bf20bfa3567a80122fdf8e8f8b28d752b609d8640f7846::miu::MIU",
            "name": "MIU",
            "symbol": "MIU",
            "logo": "https://miucoin.io/favicon.ico",
            "price": 0.0000000645,
            "price_change_1h": 0,
            "price_change_6h": 0.43,
            "price_change_1d": 0.01,
            "vol_change_1d": -27.63,
            "liq_change_1d": 0.82,
            "tx_change_1d": 4.04,
            "tx_24h": 386,
            "volume_24h": 6773,
            "volume_6h": 1234,
            "volume_4h": 987,
            "volume_1h": 456,
            "volume_30m": 321,
            "maker_24h": 65,
            "market_cap": "58074718",
            "liquidity_usd": "17540",
            "circulating_supply": "900000000000000",
            "total_supply": "900000000000000",
            "published_at": "2024-12-03T15:37:33.334Z",
            "verified": true,
            "decimals": 9
        }
    ],
    "pagination": {
        "limit": 10,
        "offset": 0
    }
}

See also:

• Environment Setup