Token - Market Data (Single)

curl --request GET \
  --url https://public-api.birdeye.so/defi/v3/token/market-data \
  --header 'X-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://public-api.birdeye.so/defi/v3/token/market-data', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "data": {
    "address": "So11111111111111111111111111111111111111112",
    "price": 185.74132384799458,
    "liquidity": 23338480211.61425,
    "total_supply": 607187823.0928401,
    "circulating_supply": 539542621.8877238,
    "fdv": 112779870085.64606,
    "market_cap": 100215360861.8438,
    "holder": 3498897,
    "is_scaled_ui_token": false,
    "multiplier": null
  }
}

GET

defi

token

market-data

Token - Market Data (Single)

curl --request GET \
  --url https://public-api.birdeye.so/defi/v3/token/market-data \
  --header 'X-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://public-api.birdeye.so/defi/v3/token/market-data', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "data": {
    "address": "So11111111111111111111111111111111111111112",
    "price": 185.74132384799458,
    "liquidity": 23338480211.61425,
    "total_supply": 607187823.0928401,
    "circulating_supply": 539542621.8877238,
    "fdv": 112779870085.64606,
    "market_cap": 100215360861.8438,
    "holder": 3498897,
    "is_scaled_ui_token": false,
    "multiplier": null
  }
}

Usage Note
Accessibility
Chain Supported

Focused market fundamentals for one token.

Returns current price together with liquidity, market cap, FDV, supply, circulating supply, and holder metrics when available.
Use ui_amount_mode=scaled for Solana Token-2022 scaled UI amounts when the token supports scaled UI amount extension.
Use this endpoint when you need current market state and valuation, but do not need timeframe-based trade activity or change windows.

Compute Unit ⚙️

This endpoint consumes 8 CU per request.

Use Cases 💡

Show current token price and market metrics in trading panels, portfolio dashboards, and token profile headers.
Monitor liquidity, supply, holder, FDV, and market-cap signals for token health.
Build ranking systems that compare valuation and liquidity quality across tokens.
Combine with metadata to create lightweight but complete token cards.

How to Use 🛠️

Provide address as the token address and set x-chain for the target network.
Set ui_amount_mode=raw for raw decimal-adjusted amounts, or ui_amount_mode=scaled for Solana Token-2022 scaled UI amounts when supported.
Use this endpoint when current price, liquidity, supply, and valuation are enough for the view.
Use Token Trade Data when you also need buy/sell activity, trader counts, and volume by timeframe.

Best Practices ✅

Use this endpoint for high-refresh token cards where Token Overview would return more data than needed.
Compare liquidity and FDV together to avoid ranking tokens by valuation without market depth context.
Keep ui_amount_mode consistent across market-data, overview, and holder endpoints for Token-2022 scaled UI amount tokens.

Authorizations

X-API-KEY

string

header

required

API key for authentication

Headers

x-chain

enum<string>

default:solana

A chain name listed in supported networks.

Available options:

solana,

ethereum,

bsc,

base,

robinhood,

sui,

mantle,

hyperevm,

arbitrum,

avalanche,

optimism,

polygon,

zksync,

monad,

aptos,

fogo,

megaeth

Query Parameters

address

string

required

The address of the token contract.

ui_amount_mode

enum<string>

default:scaled

Indicate whether to use the scaled amount for scaled ui amount tokens. Only support solana

Available options:

raw,

scaled

Response

JSON object containing market data of a specific token

success

boolean

required

Whether the request completed successfully.

data

object

required

Show child attributes