Token - Market Data (Multiple)

curl --request GET \
  --url https://public-api.birdeye.so/defi/v3/token/market-data/multiple \
  --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/multiple', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "data": {
    "So11111111111111111111111111111111111111112": {
      "address": "So11111111111111111111111111111111111111112",
      "price": 185.9491010572536,
      "liquidity": 23338480211.61425,
      "total_supply": 607187786.3995525,
      "circulating_supply": 539542585.1183889,
      "fdv": 112906023053.9405,
      "market_cap": 100327458684.87115,
      "holder": 398897,
      "is_scaled_ui_token": false,
      "multiplier": null
    },
    "mSoLzYCxHdYgdzU16g5QSh3i5K3z3KZK7ytfqcJm7So": {
      "address": "mSoLzYCxHdYgdzU16g5QSh3i5K3z3KZK7ytfqcJm7So",
      "price": 244.42542119470204,
      "liquidity": 41563027.3417533,
      "total_supply": 3548170.779026702,
      "circulating_supply": 3548170.779026702,
      "fdv": 867263137.1343358,
      "market_cap": 867263137.1343358,
      "holder": 3498897,
      "is_scaled_ui_token": false,
      "multiplier": null
    },
    "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v": {
      "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "price": 0.9999,
      "liquidity": 1317751947.580185,
      "total_supply": 8861727603.599123,
      "circulating_supply": 8861727603.599123,
      "fdv": 8860841430.838762,
      "market_cap": 8860841430.838762,
      "holder": 498897,
      "is_scaled_ui_token": false,
      "multiplier": null
    }
  }
}

GET

defi

token

market-data

multiple

Token - Market Data (Multiple)

curl --request GET \
  --url https://public-api.birdeye.so/defi/v3/token/market-data/multiple \
  --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/multiple', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "data": {
    "So11111111111111111111111111111111111111112": {
      "address": "So11111111111111111111111111111111111111112",
      "price": 185.9491010572536,
      "liquidity": 23338480211.61425,
      "total_supply": 607187786.3995525,
      "circulating_supply": 539542585.1183889,
      "fdv": 112906023053.9405,
      "market_cap": 100327458684.87115,
      "holder": 398897,
      "is_scaled_ui_token": false,
      "multiplier": null
    },
    "mSoLzYCxHdYgdzU16g5QSh3i5K3z3KZK7ytfqcJm7So": {
      "address": "mSoLzYCxHdYgdzU16g5QSh3i5K3z3KZK7ytfqcJm7So",
      "price": 244.42542119470204,
      "liquidity": 41563027.3417533,
      "total_supply": 3548170.779026702,
      "circulating_supply": 3548170.779026702,
      "fdv": 867263137.1343358,
      "market_cap": 867263137.1343358,
      "holder": 3498897,
      "is_scaled_ui_token": false,
      "multiplier": null
    },
    "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v": {
      "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "price": 0.9999,
      "liquidity": 1317751947.580185,
      "total_supply": 8861727603.599123,
      "circulating_supply": 8861727603.599123,
      "fdv": 8860841430.838762,
      "market_cap": 8860841430.838762,
      "holder": 498897,
      "is_scaled_ui_token": false,
      "multiplier": null
    }
  }
}

Usage Note
Accessibility
Chain Supported

Batch market fundamentals for multiple tokens.

Pass token addresses as a comma-separated list in list_address.
Maximum batch size is 20 token addresses per request.
Returns current price, liquidity, valuation, supply, and holder metrics for each indexed token in the request.
Use ui_amount_mode=scaled for Solana Token-2022 scaled UI amounts when tokens support scaled UI amount extension.

Compute Unit ⚙️

Batch CU is calculated as ceil(8 * count^0.8).

Use Cases 💡

Build watchlists or token screeners with current price and market data for many tokens.
Refresh portfolio token metrics in fewer API calls.
Compare liquidity, valuation, supply, and holder signals across a selected token set.
Power scheduled alert systems that evaluate many tokens together.

How to Use 🛠️

Set x-chain for the target network.
Pass list_address as comma-separated token addresses.
Set ui_amount_mode=raw or scaled consistently with your Token-2022 amount handling.
Use this endpoint when every row needs current price plus market fundamentals, but not per-timeframe trade windows.
Use the single endpoint when a user opens one token detail page.

Best Practices ✅

Use this endpoint for batch dashboards and screeners instead of looping over single-token calls.
Deduplicate addresses before requesting market data.
Combine with metadata multiple to render clean token tables with both identity and market context.

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

list_address

string

required

A list of token addresses in string separated by commas (,)

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 multiple tokens

success

boolean

required

Whether the request completed successfully.

data

object

required

Map keyed by token address. Each value is the token market-data object for that token, or null when market data is unavailable.

Show child attributes