---
title: "Get trending tokens"
method: GET
path: "/v4/data/tokens/trending"
tags: ["Token API"]
---

# Get trending tokens

`GET /v4/data/tokens/trending`

/v4/data/tokens/trending

**250 credits per API call**

Returns the top trending tokens on the specified blockchain, ranked by recent trading activity, volume, liquidity, and holder growth. Each entry includes price, market cap, liquidity, holder count, and per-timeframe (1h/4h/12h/24h) statistics for price change, volume, transactions, buyers, and sellers.

Supported blockchains:

*   Ethereum - ethereum-mainnet
*   BNB Smart Chain - bsc-mainnet
*   Polygon - polygon-mainnet
*   Avalanche - avax-mainnet
*   Arbitrum - arb-one-mainnet
*   Optimism - optimism-mainnet
*   Base - base-mainnet
*   Monad - monad-mainnet
*   Solana - solana-mainnet

## Query parameters

- `chain` 'ethereum-mainnet' | 'bsc-mainnet' | 'polygon-mainnet' | 'avax-mainnet' | 'arb-one-mainnet' | 'optimism-mainnet' | 'base-mainnet' | 'monad-mainnet' | 'solana-mainnet', required — Chains supported by the trending tokens endpoint.
- `limit` number

## Response `200`

OK

- TrendingTokenStats[]
  - `chain` 'ethereum-mainnet' | 'bsc-mainnet' | 'polygon-mainnet' | 'avax-mainnet' | 'arb-one-mainnet' | 'optimism-mainnet' | 'base-mainnet' | 'monad-mainnet' | 'solana-mainnet' — Chains supported by the trending tokens endpoint.
  - `tokenAddress` string — Token contract address.
  - `name` string — Token name.
  - `uniqueName` string, nullable — Unique slug for the token, when available.
  - `symbol` string — Token symbol or ticker.
  - `decimals` integer — Number of token decimals.
  - `logo` string, nullable — URL of the token logo, when available.
  - `usdPrice` number, double — Current price in USD.
  - `createdAt` integer — Unix timestamp (seconds) of token creation.
  - `marketCap` number — Market capitalization in USD.
  - `liquidityUsd` number — Approximate on-chain liquidity in USD.
  - `holders` integer — Number of token holders.
  - `pricePercentChange` TrendingTokenTimeframeStats — Per-timeframe numeric statistics (1h, 4h, 12h, 24h).
    - `1h` number — Value over the last hour.
    - `4h` number — Value over the last 4 hours.
    - `12h` number — Value over the last 12 hours.
    - `24h` number — Value over the last 24 hours.
  - `totalVolume` TrendingTokenTimeframeStats — Per-timeframe numeric statistics (1h, 4h, 12h, 24h).
    - `1h` number — Value over the last hour.
    - `4h` number — Value over the last 4 hours.
    - `12h` number — Value over the last 12 hours.
    - `24h` number — Value over the last 24 hours.
  - `transactions` TrendingTokenTimeframeStats — Per-timeframe numeric statistics (1h, 4h, 12h, 24h).
    - `1h` number — Value over the last hour.
    - `4h` number — Value over the last 4 hours.
    - `12h` number — Value over the last 12 hours.
    - `24h` number — Value over the last 24 hours.
  - `buyTransactions` TrendingTokenTimeframeStats — Per-timeframe numeric statistics (1h, 4h, 12h, 24h).
    - `1h` number — Value over the last hour.
    - `4h` number — Value over the last 4 hours.
    - `12h` number — Value over the last 12 hours.
    - `24h` number — Value over the last 24 hours.
  - `sellTransactions` TrendingTokenTimeframeStats — Per-timeframe numeric statistics (1h, 4h, 12h, 24h).
    - `1h` number — Value over the last hour.
    - `4h` number — Value over the last 4 hours.
    - `12h` number — Value over the last 12 hours.
    - `24h` number — Value over the last 24 hours.
  - `buyers` TrendingTokenTimeframeStats — Per-timeframe numeric statistics (1h, 4h, 12h, 24h).
    - `1h` number — Value over the last hour.
    - `4h` number — Value over the last 4 hours.
    - `12h` number — Value over the last 12 hours.
    - `24h` number — Value over the last 24 hours.
  - `sellers` TrendingTokenTimeframeStats — Per-timeframe numeric statistics (1h, 4h, 12h, 24h).
    - `1h` number — Value over the last hour.
    - `4h` number — Value over the last 4 hours.
    - `12h` number — Value over the last 12 hours.
    - `24h` number — Value over the last 24 hours.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
- `403` — Forbidden. The request is authenticated, but it is not possible to perform the operation due to logical error or invalid permissions.
- `500` — Internal server error. There was an error on the server during the processing of the request.

---

[API](https://skmtc.net/tatum/apis/blockchain-data.md) · [All operations](https://skmtc.net/tatum/apis/blockchain-data/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tatum/blockchain-data/revisions/8622ee4b8fae/schema)