Coin Trending

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

string

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

string

Trading volume in 24h.

├─ volume_6h

string

Trading volume in 6h.

├─ volume_4h

string

Trading volume in 4h.

├─ volume_30m

string

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_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.5",
            "volume_6h": "2836299.83",
            "volume_4h": "2287841.14",
            "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

Last updated