> ## Documentation Index
> Fetch the complete documentation index at: https://data.birdeye.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Token - Trending List
> Retrieve a dynamic and up-to-date list of trending tokens based on specified sorting criteria.
Dynamic token discovery ranked by recent trend signals.
Use sorting and interval parameters to define what “trending” means for your screen or workflow.
This is a discovery endpoint, not a full token fundamentals endpoint.
Results are paginated for leaderboard-style browsing.
Standard
Lite
Starter
Premium
Business
Enterprise
All chains ⛓️ ✨
This endpoint consumes 25 CU per request.
Surface hot tokens across supported chains.
Build trend boards, token-discovery feeds, and alert candidates.
Feed watchlist generation with recently accelerating tokens.
Set x-chain for the target network.
Choose the sort and interval parameters that match the trend horizon you care about.
Page through results with offset and limit.
Use this endpoint for discovery first, then hydrate shortlisted tokens with market, price, or security data.
Keep the selected interval visible in product UI so users understand the trend horizon.
## OpenAPI
````yaml openapi/data/openapi_docs.json GET /defi/token_trending
openapi: 3.1.0
info:
version: 1.1.0
title: Birdeye Data API
description: >-
Birdeye Data API is a full-spectrum blockchain and DEX data platform for
teams that need production-grade crypto market intelligence across tokens,
pairs, wallets, traders, protocols, and chains.
From real-time prices, OHLCV, liquidity, and transaction flow to holder
analytics, token and pair overviews, wallet portfolio and PnL, smart money,
discovery, security, and blockchain-level utilities, Birdeye gives you a
unified data layer for building serious crypto products at scale.
Use it to power exchange interfaces, trading terminals, bots, market-making
systems, quant research, alpha screeners, portfolio apps, wallet
intelligence tools, alerting systems, analytics dashboards, and back-office
data pipelines. Whether your users are retail traders, pro desks, analysts,
or infrastructure teams, Birdeye helps you ship faster with broad market
coverage and API surfaces that support both lightweight integrations and
data-heavy workflows.
To start, create an account at [bds.birdeye.so](https://bds.birdeye.so),
generate an API key from the `Security` tab, and send it in the `X-API-KEY`
header on every request.
servers:
- url: https://public-api.birdeye.so
security:
- apiKeyAuth: []
tags:
- name: Price & OHLCV
- name: Stats
- name: Token/Market List
- name: Transactions
- name: Wallet, Networth & PnL
- name: Balance & Transfer
- name: Holder
- name: Alltime & History
- name: Blockchain
- name: Account
- name: Token
- name: Transaction
- name: Creation & Trending
- name: Meme
- name: Security
- name: Search & Utils
- name: Smart Money
- name: Global Fees Paid
- name: DEX & Protocol
- name: Wallet Identity
paths:
/defi/token_trending:
get:
tags:
- Creation & Trending
summary: Token - Trending List
description: >-
Retrieve a dynamic and up-to-date list of trending tokens based on
specified sorting criteria.
operationId: get-defi-token_trending
parameters:
- $ref: '#/components/parameters/xChainParam'
- $ref: '#/components/parameters/sortByTokenTrendingParam'
- $ref: '#/components/parameters/intervalTrendingParam'
- $ref: '#/components/parameters/sortTypeAscParam'
- $ref: '#/components/parameters/offsetParam'
- $ref: '#/components/parameters/limitParam'
- $ref: '#/components/parameters/uiAmountModeSplitParam'
responses:
'200':
$ref: '#/components/responses/DefiTokenTrendingList'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'429':
$ref: '#/components/responses/429'
'500':
$ref: '#/components/responses/500'
components:
parameters:
xChainParam:
name: x-chain
description: A chain name listed in supported networks.
in: header
required: false
schema:
type: string
enum:
- solana
- ethereum
- bsc
- base
- robinhood
- sui
- mantle
- hyperevm
- arbitrum
- avalanche
- optimism
- polygon
- zksync
- monad
- aptos
- fogo
- megaeth
default: solana
sortByTokenTrendingParam:
name: sort_by
description: Specify the sort field.
in: query
required: true
schema:
type: string
enum:
- rank
- volumeUSD
- liquidity
default: rank
intervalTrendingParam:
name: interval
description: Specify the interval of trending.
in: query
required: false
schema:
type: string
enum:
- 1h
- 4h
- 24h
default: 24h
sortTypeAscParam:
name: sort_type
description: Specify the sort order.
in: query
required: true
schema:
type: string
enum:
- asc
- desc
default: asc
offsetParam:
name: offset
description: >-
Specify the offset for pagination. Filter for records with offset
greater than the specified offset value, including those with offset
equal to the specified offset.
in: query
required: false
schema:
type: integer
default: 0
limitParam:
name: limit
description: Number of items per page.
in: query
required: false
schema:
type: integer
default: 50
minimum: 1
maximum: 50
uiAmountModeSplitParam:
name: ui_amount_mode
description: >-
Indicate whether to use the scaled amount for scaled ui amount tokens.
Only support solana
in: query
required: false
schema:
type: string
enum:
- raw
- scaled
default: scaled
responses:
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
success: false
message: Bad request
'401':
description: Unauthorized. API key is missing or invalid
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
success: false
message: Unauthorized
'403':
description: Forbidden. Request is blacklisted or not whitelisted
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
success: false
message: Access Denied
'429':
description: Too Many Requests. Rate limit reached
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
success: false
message: Too many requests
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
success: false
message: Internal Server Error
DefiTokenTrendingList:
description: JSON object containing a list of trending tokens
content:
application/json:
schema:
$ref: '#/components/schemas/DefiTokenTrendingListResponse'
examples:
SolanaScaledUIAmount:
value:
success: true
data:
updateUnixTime: 1726681733
updateTime: '2024-09-18T17:48:53'
tokens:
- address: HJXh1XULVe2Mdp6mTKd5K7of1uFqBTbmcWzvBv6cpump
decimals: 6
liquidity: 34641.80933146691
logoURI: >-
https://ipfs.io/ipfs/QmR7QnPaYcfwoG8oymK5JRDsB9GSgHr71mJmL2MuJ7Qk3x
name: AVOCATO
symbol: ATO
volume24hUSD: 1202872.3148187269
volume24hChangePercent: 33
rank: 1
price: 0.00010551649518689046
price24hChangePercent: 210
fdv: 17028232129
marketcap: 28232129
- address: HYFDwieKWth1kzKbtLFMtgMVwukyvyWNYFxyQDcWpump
decimals: 6
liquidity: 73874.80948083404
logoURI: >-
https://ipfs.io/ipfs/QmUxhHFAugzzWmTMCMCky1QjaJNjtpBNhC2iRELb77Vqfw
name: The Liquidator
symbol: LIQUIDATOR
volume24hUSD: 920580.3615402475
volume24hChangePercent: 5
rank: 2
price: 0.0006106216453936813
price24hChangePercent: 12
fdv: 1495237953
marketcap: 5425292
total: 1000
Tokens:
value:
success: true
data:
updateUnixTime: 1726681733
updateTime: '2024-09-18T17:48:53'
tokens:
- address: HJXh1XULVe2Mdp6mTKd5K7of1uFqBTbmcWzvBv6cpump
decimals: 6
liquidity: 34641.80933146691
logoURI: >-
https://ipfs.io/ipfs/QmR7QnPaYcfwoG8oymK5JRDsB9GSgHr71mJmL2MuJ7Qk3x
name: AVOCATO
symbol: ATO
volume24hUSD: 1202872.3148187269
volume24hChangePercent: 33
rank: 1
price: 0.00010551649518689046
price24hChangePercent: 210
fdv: 17028232129
marketcap: 28232129
- address: HYFDwieKWth1kzKbtLFMtgMVwukyvyWNYFxyQDcWpump
decimals: 6
liquidity: 73874.80948083404
logoURI: >-
https://ipfs.io/ipfs/QmUxhHFAugzzWmTMCMCky1QjaJNjtpBNhC2iRELb77Vqfw
name: The Liquidator
symbol: LIQUIDATOR
volume24hUSD: 920580.3615402475
volume24hChangePercent: 5
rank: 2
price: 0.0006106216453936813
price24hChangePercent: 12
fdv: 1495237953
marketcap: 5425292
total: 1000
schemas:
DefiTokenTrendingListResponse:
type: object
required:
- success
- data
properties:
success:
type: boolean
description: Whether the request completed successfully.
data:
type: object
description: Trending-token payload with ranking metadata and token rows.
properties:
updateUnixTime:
type: integer
description: >-
Unix timestamp in seconds when the trending snapshot was last
refreshed.
updateTime:
type: string
description: >-
Human-readable timestamp when the trending snapshot was last
refreshed.
total:
type: number
description: >-
Total number of tokens included in the trending ranking before
pagination is applied.
tokens:
type: array
description: Trending token rows returned for the current page.
items:
type: object
description: One token row from the trending list.
properties:
address:
type: string
description: Token mint or contract address.
decimals:
type: integer
description: Number of decimal places used by the token.
liquidity:
type: number
description: Current token liquidity in USD.
logoURI:
type: string
description: Logo image URL for the token.
name:
type: string
description: Display name of the token.
symbol:
type: string
description: Ticker symbol for the token.
volume24hUSD:
type: number
description: Total traded USD volume during the latest 24-hour window.
volume24hChangePercent:
type: number
description: >-
Percentage change in 24-hour USD volume versus the
previous 24-hour window.
rank:
type: integer
description: Trending rank of the token in the returned list.
price:
type: number
description: Latest token price in USD.
price24hChangePercent:
type: number
description: Percentage change in price over the latest 24-hour window.
fdv:
type: number
description: >-
Fully diluted valuation based on total supply and latest
price.
marketcap:
type: number
description: Current market capitalization.
ErrorResponse:
type: object
properties:
success:
type: boolean
message:
type: string
securitySchemes:
apiKeyAuth:
type: apiKey
in: header
name: X-API-KEY
description: API key for authentication
````