Search - Token, market Data

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

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

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

{
  "success": true,
  "data": {
    "items": [
      {
        "type": "token",
        "result": [
          {
            "name": "TRENDSDOTFUN",
            "symbol": "",
            "address": "CdsF47CkMGnXnMuGNPw9TpCbE6hxRvA4XUbxbZcLrfJ8",
            "network": "solana",
            "decimals": 6,
            "verified": false,
            "fdv": 13697.614698138917,
            "market_cap": 13697.614698138917,
            "liquidity": 60054.03786109897,
            "price": 0.000013697614670743687,
            "price_change_24h_percent": 333.97707074856015,
            "sell_24h": 4088,
            "sell_24h_change_percent": null,
            "buy_24h": 4374,
            "buy_24h_change_percent": null,
            "unique_wallet_24h": 203,
            "unique_wallet_24h_change_percent": null,
            "trade_24h": 8462,
            "trade_24h_change_percent": null,
            "volume_24h_change_percent": null,
            "volume_24h_usd": 1867782.2902830783,
            "last_trade_unix_time": 1749490559,
            "last_trade_human_time": "2025-06-09T17:35:59",
            "updated_time": 1749491343,
            "creation_time": "2025-06-09T17:13:02.490Z",
            "is_scaled_ui_token": false,
            "multiplier": null
          }
        ]
      },
      {
        "type": "market",
        "result": []
      }
    ]
  }
}

GET

defi

Search - Token, market Data

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

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

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

{
  "success": true,
  "data": {
    "items": [
      {
        "type": "token",
        "result": [
          {
            "name": "TRENDSDOTFUN",
            "symbol": "",
            "address": "CdsF47CkMGnXnMuGNPw9TpCbE6hxRvA4XUbxbZcLrfJ8",
            "network": "solana",
            "decimals": 6,
            "verified": false,
            "fdv": 13697.614698138917,
            "market_cap": 13697.614698138917,
            "liquidity": 60054.03786109897,
            "price": 0.000013697614670743687,
            "price_change_24h_percent": 333.97707074856015,
            "sell_24h": 4088,
            "sell_24h_change_percent": null,
            "buy_24h": 4374,
            "buy_24h_change_percent": null,
            "unique_wallet_24h": 203,
            "unique_wallet_24h_change_percent": null,
            "trade_24h": 8462,
            "trade_24h_change_percent": null,
            "volume_24h_change_percent": null,
            "volume_24h_usd": 1867782.2902830783,
            "last_trade_unix_time": 1749490559,
            "last_trade_human_time": "2025-06-09T17:35:59",
            "updated_time": 1749491343,
            "creation_time": "2025-06-09T17:13:02.490Z",
            "is_scaled_ui_token": false,
            "multiplier": null
          }
        ]
      },
      {
        "type": "market",
        "result": []
      }
    ]
  }
}

Usage Note
Accessibility
Chain Supported

Search entry point for tokens and markets.

Search by token name, symbol, token address, or market address.
target, search_mode, and search_by shape how broad or exact the search should be.
Results are paginated with offset and limit up to 20.
ui_amount_mode=scaled applies Solana Token-2022 scaled UI amount where supported.

Compute Unit ⚙️

This endpoint consumes 20 CU per request.

Use Cases 💡

Power token and market search bars.
Resolve noisy symbols into exact token or market candidates.
Support discovery flows before users open token detail pages.

How to Use 🛠️

Set x-chain or use the supported search chain mode.
Pass keyword, then narrow with target, search_mode, or search_by if needed.
Use offset and limit for paginated result sets.

Best Practices ✅

Use exact address search when you already know the token or market address.
Use fuzzy or broader search for UI search boxes, then hydrate the selected result with dedicated data endpoints.
Keep limit small for interactive search experiences.

Authorizations

X-API-KEY

string

header

required

API key for authentication

Query Parameters

chain

enum<string>

default:all

Specify the chain.

Available options:

all,

solana,

ethereum,

bsc,

base,

robinhood,

sui,

mantle,

hyperevm,

arbitrum,

avalanche,

optimism,

polygon,

zksync,

monad,

aptos,

fogo,

megaeth

keyword

string

target

enum<string>

default:all

An option to search tokens based on their expected results as token, market, or both.

Available options:

all,

token,

market

search_mode

enum<string>

default:exact

An option to search tokens with exact match or partially match.

Available options:

exact,

fuzzy

search_by

enum<string>

default:symbol

An option to search tokens by symbol, name, or both.

Available options:

combination,

address,

name,

symbol

sort_by

enum<string>

default:volume_24h_usd

required

Specify the sort field.

Available options:

fdv,

marketcap,

liquidity,

price,

price_change_24h_percent,

trade_24h,

trade_24h_change_percent,

buy_24h,

buy_24h_change_percent,

sell_24h,

sell_24h_change_percent,

unique_wallet_24h,

unique_view_24h_change_percent,

last_trade_unix_time,

volume_24h_usd,

volume_24h_change_percent

sort_type

enum<string>

default:desc

required

Specify the sort order.

Available options:

desc,

asc

verify_token

enum<boolean>

A filter to retrieve tokens based on their verification status (supported on Solana).

Available options:

true,

false

markets

string

A comma-separated list of market sources to filter results (supported on Solana). Available options: ['Raydium', 'Raydium CP', 'Raydium Clamm', 'Meteora', 'Meteora DLMM', 'Fluxbeam', 'Pump.fun', 'OpenBook', 'OpenBook V2', 'Orca'].

offset

integer

default:0

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.

limit

integer

default:20

Number of items per page.

Required range: 1 <= x <= 20

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

Search for token and market data matching keyword, tokenAddress using full-text search

success

boolean

required

Whether the request completed successfully.

data

object

required

Search results grouped by result type.

Show child attributes