Token - Metadata (Multiple)

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

{
  "data": {
    "So11111111111111111111111111111111111111112": {
      "address": "So11111111111111111111111111111111111111112",
      "symbol": "SOL",
      "name": "Wrapped SOL",
      "decimals": 9,
      "extensions": {
        "coingecko_id": "solana",
        "website": "https://solana.com/",
        "twitter": "https://twitter.com/solana",
        "discord": "https://discordapp.com/invite/pquxPsq",
        "medium": "https://medium.com/solana-labs"
      },
      "logo_uri": "https://img.fotofolio.xyz/?url=https%3A%2F%2Fraw.githubusercontent.com%2Fsolana-labs%2Ftoken-list%2Fmain%2Fassets%2Fmainnet%2FSo11111111111111111111111111111111111111112%2Flogo.png"
    },
    "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v": {
      "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "decimals": 6,
      "symbol": "USDC",
      "name": "USD Coin",
      "extensions": {
        "coingecko_id": "usd-coin",
        "website": "https://www.circle.com/en/usdc",
        "twitter": "https://twitter.com/circle",
        "medium": "https://medium.com/centre-blog",
        "discord": "https://discord.com/invite/buildoncircle"
      },
      "logo_uri": "https://img.fotofolio.xyz/?url=https%3A%2F%2Fraw.githubusercontent.com%2Fsolana-labs%2Ftoken-list%2Fmain%2Fassets%2Fmainnet%2FEPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v%2Flogo.png"
    }
  },
  "success": true
}

GET

defi

token

meta-data

multiple

Token - Metadata (Multiple)

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

{
  "data": {
    "So11111111111111111111111111111111111111112": {
      "address": "So11111111111111111111111111111111111111112",
      "symbol": "SOL",
      "name": "Wrapped SOL",
      "decimals": 9,
      "extensions": {
        "coingecko_id": "solana",
        "website": "https://solana.com/",
        "twitter": "https://twitter.com/solana",
        "discord": "https://discordapp.com/invite/pquxPsq",
        "medium": "https://medium.com/solana-labs"
      },
      "logo_uri": "https://img.fotofolio.xyz/?url=https%3A%2F%2Fraw.githubusercontent.com%2Fsolana-labs%2Ftoken-list%2Fmain%2Fassets%2Fmainnet%2FSo11111111111111111111111111111111111111112%2Flogo.png"
    },
    "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v": {
      "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "decimals": 6,
      "symbol": "USDC",
      "name": "USD Coin",
      "extensions": {
        "coingecko_id": "usd-coin",
        "website": "https://www.circle.com/en/usdc",
        "twitter": "https://twitter.com/circle",
        "medium": "https://medium.com/centre-blog",
        "discord": "https://discord.com/invite/buildoncircle"
      },
      "logo_uri": "https://img.fotofolio.xyz/?url=https%3A%2F%2Fraw.githubusercontent.com%2Fsolana-labs%2Ftoken-list%2Fmain%2Fassets%2Fmainnet%2FEPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v%2Flogo.png"
    }
  },
  "success": true
}

Usage Note
Accessibility
Chain Supported

Batch token identity lookup.

Always use checksum contract addresses on EVM chains and canonical token mint addresses on Solana-like chains.
Pass token addresses as a comma-separated list in list_address.
Maximum batch size is 50 token addresses per request.
Token metadata can vary by chain and token standard.
Response entries may be null or missing fields if metadata is not indexed or unavailable for a token.
Use this endpoint for batch metadata lookups across token lists, watchlists, search results, or portfolio rows.
Cache token metadata where possible because it changes less frequently than market data.

Compute Unit ⚙️

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

Use Cases 💡

Hydrate token lists with names, symbols, decimals, and logos in one request.
Prepare metadata for portfolio, screener, and watchlist pages.
Reduce request volume when loading many token cards at once.
Join metadata with price, volume, and liquidity data for richer token tables.

How to Use 🛠️

Set x-chain for the target network.
Pass list_address as comma-separated token addresses.
Cache returned metadata and refresh it less frequently than market metrics.

Best Practices ✅

Use this endpoint before batch market-data calls so every row has readable token identity.
Deduplicate token addresses before calling to keep requests clean.
Store token decimals from metadata as shared formatting context for balances, prices, and quantities.

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 (,)

Response

JSON object containing metadata of multiple tokens

success

boolean

required

Whether the request completed successfully.

data

object

required

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

Show child attributes