---
title: "Search - Token, market Data"
method: GET
path: "/defi/v3/search"
tags: ["Search & Utils"]
---

# Search - Token, market Data

`GET /defi/v3/search`

Search for tokens and market data by providing a name, symbol, token address, or market address.

## Query parameters

- `chain` 'all' | 'solana' | 'ethereum' | 'arbitrum' | 'avalanche' | 'bsc' | 'optimism' | 'polygon' | 'base' | 'zksync' | 'monad' | 'hyperevm' | 'aptos' | 'fogo' | 'mantle' | 'megaeth' | 'robinhood' | 'sui'
- `keyword` string
- `target` 'all' | 'token' | 'market'
- `search_mode` 'exact' | 'fuzzy'
- `search_by` 'combination' | 'address' | 'name' | 'symbol'
- `sort_by` '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', required
- `sort_type` 'desc' | 'asc', required
- `verify_token` true | false
- `markets` string
- `offset` integer
- `limit` integer
- `ui_amount_mode` 'raw' | 'scaled'

## Response `200`

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

- SearchResponse
  - `success` boolean, required
  - `data` object, required
    - `items` object[], required
      - `type` string, required
      - `result` union[], required
        - union
          - object
            - `name` string, required
            - `symbol` string, required
            - `address` string, required
            - `network` string
            - `decimals` number, required
            - `logo_uri` string, required
            - `verified` boolean
            - `fdv` number, required
            - `market_cap` number
            - `liquidity` number, required
            - `price` number, required
            - `price_change_24h_percent` number, required
            - `sell_24h` integer
            - `sell_24h_change_percent` number
            - `buy_24h` integer
            - `buy_24h_change_percent` number
            - `unique_wallet_24h` number
            - `unique_wallet_24h_change_percent` number
            - `trade_24h` integer
            - `trade_24h_change_percent` number
            - `volume_24h_change_percent` number, required
            - `volume_24h_usd` number, required
            - `last_trade_unix_time` number
            - `last_trade_human_time` string
            - `supply` number
            - `updated_time` integer
          - object
            - `name` string, required
            - `address` string, required
            - `network` string
            - `liquidity` number, required
            - `unique_wallet_24h` integer
            - `unique_wallet_24h_change_percent` number
            - `trade_24h` integer
            - `trade_24h_change_percent` number
            - `volume_24h_usd` number
            - `last_trade_unix_time` integer
            - `amount_base` number
            - `amount_quote` number

## Other responses

- `400` — Bad Request
- `401` — Unauthorized. API key is missing or invalid
- `403` — Forbidden. Request is blacklisted or not whitelisted
- `429` — Too Many Requests. Rate limit reached
- `500` — Internal Server Error

---

[API](https://skmtc.net/birdeye/apis/birdeye-data-api.md) · [All operations](https://skmtc.net/birdeye/apis/birdeye-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/birdeye/birdeye-data-api/revisions/fcaba926a089/schema)