Coin Trends

Retrieve a list of trending coins based on a given time period (last 30 minutes, 1 hour, 6 hours, 24 hours).

The formular of trending coin please contact: @hiephho

Endpoint

POST /api/v1/partner/coin-trending

Request Body

Parameters

Field	Type	Required	Description
pagination	object	No	Pagination
├─ limit	number	No	Max number of items to return. Default: 20, Max: 200.
└─ offset	number	No	Index to start the results from. Default: 0.
score_period	string	Yes	Period trending score. Choices are: 30m, 1h, 4h, 6h 24h.
filters	object	No	Filters
└─ coin_ids	string[]	No	Array of coin_id to filter (use to filter favorite coins).

Example

{
  "pagination": {
    "limit": 10,
    "offset": 0
  },
  "score_period": "24h",
  "filters": {
    "coin_ids": [
      "0x32a976482bf4154961bf20bfa3567a80122fdf8e8f8b28d752b609d8640f7846::miu::MIU",
      "0xdeeb7a4662eec9f2f3def03fb937a663dddaa2e215b8078a284d026b7946c270::deep::DEEP"
    ]
  }
}

Headers

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

Response Body

Fields

Field	Type	Description
data	array	List of trending 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_1d	number	% price change in the last 24 hours.
├─ price_change_6h	number	% price change in the last 6 hours.
├─ price_change_4h	number	% price change in the last 4 hours.
├─ price_change_1h	number	% price change in the last hour.
├─ price_change_30m	number	% price change in the last 30 minutes.
├─ 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": "OK",
    "data": [
        {
            "coin_type": "0xb2d912e4f100e03b7de58d874835e358dc2802f2fb8559f56a70a7c900f8fc78::jug_sui::JUG_SUI",
            "name": "Jugemu Sui",
            "symbol": "jugSUI",
            "logo": "https://liqag.wal.app/lsts/jugSUI.png",
            "price": 3.513,
            "price_change_1d": 2.02,
            "price_change_6h": 1.24,
            "price_change_4h": 2.37,
            "price_change_1h": -1.97,
            "price_change_30m": -0.7,
            "vol_change_1d": -39.92,
            "liq_change_1d": 1.86,
            "tx_change_1d": -35.61,
            "tx_24h": 810,
            "volume_24h": 96673.77,
            "volume_6h": 47946.02,
            "volume_4h": 41737.91,
            "volume_1h": 12345.67,
            "volume_30m": 7771.5,
            "maker_24h": 283,
            "market_cap": "0",
            "liquidity_usd": "34842.06",
            "circulating_supply": "0",
            "total_supply": "0",
            "published_at": "2025-04-21T23:07:40.803Z",
            "verified": true,
            "rank": 1,
            "decimals": 9
        },
        {
            "coin_type": "0x7262fb2f7a3a14c888c438a3cd9b912469a58cf60f367352c46584262e8299aa::ika::IKA",
            "name": "IKA Token",
            "symbol": "IKA",
            "logo": "https://token-logos.noodles.fi/ika.svg",
            "price": 0.0368,
            "price_change_1d": -3.3,
            "price_change_6h": -2.66,
            "price_change_4h": 0.14,
            "price_change_1h": -4.05,
            "price_change_30m": -2.05,
            "vol_change_1d": 6.67,
            "liq_change_1d": -3.25,
            "tx_change_1d": -12.62,
            "tx_24h": 11221,
            "volume_24h": 7317387.53,
            "volume_6h": 2836299.83,
            "volume_4h": 2287841.14,
            "volume_1h": 368241.21,
            "volume_30m": 235308.84,
            "maker_24h": 1561,
            "market_cap": "368232714.29",
            "liquidity_usd": "2838833.38",
            "circulating_supply": "10000000000",
            "total_supply": "10000000000",
            "published_at": "2025-07-16T14:25:36.944Z",
            "verified": true,
            "rank": 2,
            "decimals": 9
        }
    ],
    "pagination": {
        "offset": 0,
        "limit": 2
    }
}

See also: Environment Setup