---
title: "Token - Trade Data (Single)"
method: GET
path: "/defi/v3/token/trade-data/single"
tags: ["Stats"]
---

# Token - Trade Data (Single)

`GET /defi/v3/token/trade-data/single`

Retrieve trade data of a specified token.

## Query parameters

- `address` string, required
- `frames` string
- `ui_amount_mode` 'raw' | 'scaled'

## Headers

- `x-chain` 'solana' | 'ethereum' | 'arbitrum' | 'avalanche' | 'bsc' | 'optimism' | 'polygon' | 'base' | 'zksync' | 'monad' | 'hyperevm' | 'aptos' | 'fogo' | 'mantle' | 'megaeth' | 'robinhood' | 'sui'

## Response `200`

JSON object containing trade data of a specific token

- DefiTokenTradeDataSingleResponse
  - `success` boolean, required
  - `data` DefiTokenTradeDataObject, required
    - `address` string, required
    - `liquidity` number, required
    - `last_trade_unix_time` number, required
    - `last_trade_human_time` string, required
    - `price` number, required
    - `history_30m_price` number, required
    - `price_change_30m_percent` number, required
    - `history_1h_price` number, required
    - `price_change_1h_percent` number, required
    - `history_2h_price` number, required
    - `price_change_2h_percent` number, required
    - `history_4h_price` number, required
    - `price_change_4h_percent` number, required
    - `history_6h_price` number, required
    - `price_change_6h_percent` number, required
    - `history_8h_price` number, required
    - `price_change_8h_percent` number, required
    - `history_12h_price` number, required
    - `price_change_12h_percent` number, required
    - `history_24h_price` number, required
    - `price_change_24h_percent` number, required
    - `unique_wallet_30m` number, required
    - `unique_wallet_history_30m` number, required
    - `unique_wallet_30m_change_percent` number, required
    - `unique_wallet_1h` number, required
    - `unique_wallet_history_1h` number, required
    - `unique_wallet_1h_change_percent` number, required
    - `unique_wallet_2h` number, required
    - `unique_wallet_history_2h` number, required
    - `unique_wallet_2h_change_percent` number, required
    - `unique_wallet_4h` number, required
    - `unique_wallet_history_4h` number, required
    - `unique_wallet_4h_change_percent` number, required
    - `unique_wallet_8h` number, required
    - `unique_wallet_history_8h` number, required
    - `unique_wallet_8h_change_percent` number, required
    - `unique_wallet_24h` number, required
    - `unique_wallet_history_24h` number, required
    - `unique_wallet_24h_change_percent` number, required
    - `trade_30m` number, required
    - `trade_history_30m` number, required
    - `trade_30m_change_percent` number, required
    - `sell_30m` number, required
    - `sell_history_30m` number, required
    - `sell_30m_change_percent` number, required
    - `buy_30m` number, required
    - `buy_history_30m` number, required
    - `buy_30m_change_percent` number, required
    - `volume_30m` number, required
    - `volume_30m_usd` number, required
    - `volume_history_30m` number, required
    - `volume_history_30m_usd` number, required
    - `volume_30m_change_percent` number, required
    - `volume_buy_30m` number, required
    - `volume_buy_30m_usd` number, required
    - `volume_buy_history_30m` number, required
    - `volume_buy_history_30m_usd` number, required
    - `volume_buy_30m_change_percent` number, required
    - `volume_sell_30m` number, required
    - `volume_sell_30m_usd` number, required
    - `volume_sell_history_30m` number, required
    - `volume_sell_history_30m_usd` number, required
    - `volume_sell_30m_change_percent` number, required
    - `trade_1h` number, required
    - `trade_history_1h` number, required
    - `trade_1h_change_percent` number, required
    - `sell_1h` number, required
    - `sell_history_1h` number, required
    - `sell_1h_change_percent` number, required
    - `buy_1h` number, required
    - `buy_history_1h` number, required
    - `buy_1h_change_percent` number, required
    - `volume_1h` number, required
    - `volume_1h_usd` number, required
    - `volume_history_1h` number, required
    - `volume_history_1h_usd` number, required
    - `volume_1h_change_percent` number, required
    - `volume_buy_1h` number, required
    - `volume_buy_1h_usd` number, required
    - `volume_buy_history_1h` number, required
    - `volume_buy_history_1h_usd` number, required
    - `volume_buy_1h_change_percent` number, required
    - `volume_sell_1h` number, required
    - `volume_sell_1h_usd` number, required
    - `volume_sell_history_1h` number, required
    - `volume_sell_history_1h_usd` number, required
    - `volume_sell_1h_change_percent` number, required
    - `trade_2h` number, required
    - `trade_history_2h` number, required
    - `trade_2h_change_percent` number, required
    - `sell_2h` number, required
    - `sell_history_2h` number, required
    - `sell_2h_change_percent` number, required
    - `buy_2h` number, required
    - `buy_history_2h` number, required
    - `buy_2h_change_percent` number, required
    - `volume_2h` number, required
    - `volume_2h_usd` number, required
    - `volume_history_2h` number, required
    - `volume_history_2h_usd` number, required
    - `volume_2h_change_percent` number, required
    - `volume_buy_2h` number, required
    - `volume_buy_2h_usd` number, required
    - `volume_buy_history_2h` number, required
    - `volume_buy_history_2h_usd` number, required
    - `volume_buy_2h_change_percent` number, required
    - `volume_sell_2h` number, required
    - `volume_sell_2h_usd` number, required
    - `volume_sell_history_2h` number, required
    - `volume_sell_history_2h_usd` number, required
    - `volume_sell_2h_change_percent` number, required
    - `trade_4h` number, required
    - `trade_history_4h` number, required
    - `trade_4h_change_percent` number, required
    - `sell_4h` number, required
    - `sell_history_4h` number, required
    - `sell_4h_change_percent` number, required
    - `buy_4h` number, required
    - `buy_history_4h` number, required
    - `buy_4h_change_percent` number, required
    - `volume_4h` number, required
    - `volume_4h_usd` number, required
    - `volume_history_4h` number, required
    - `volume_history_4h_usd` number, required
    - `volume_4h_change_percent` number, required
    - `volume_buy_4h` number, required
    - `volume_buy_4h_usd` number, required
    - `volume_buy_history_4h` number, required
    - `volume_buy_history_4h_usd` number, required
    - `volume_buy_4h_change_percent` number, required
    - `volume_sell_4h` number, required
    - `volume_sell_4h_usd` number, required
    - `volume_sell_history_4h` number, required
    - `volume_sell_history_4h_usd` number, required
    - `volume_sell_4h_change_percent` number, required
    - `trade_8h` number, required
    - `trade_history_8h` number, required
    - `trade_8h_change_percent` number, required
    - `sell_8h` number, required
    - `sell_history_8h` number, required
    - `sell_8h_change_percent` number, required
    - `buy_8h` number, required
    - `buy_history_8h` number, required
    - `buy_8h_change_percent` number, required
    - `volume_8h` number, required
    - `volume_8h_usd` number, required
    - `volume_history_8h` number, required
    - `volume_history_8h_usd` number, required
    - `volume_8h_change_percent` number, required
    - `volume_buy_8h` number, required
    - `volume_buy_8h_usd` number, required
    - `volume_buy_history_8h` number, required
    - `volume_buy_history_8h_usd` number, required
    - `volume_buy_8h_change_percent` number, required
    - `volume_sell_8h` number, required
    - `volume_sell_8h_usd` number, required
    - `volume_sell_history_8h` number, required
    - `volume_sell_history_8h_usd` number, required
    - `volume_sell_8h_change_percent` number, required
    - `trade_24h` number, required
    - `trade_history_24h` number, required
    - `trade_24h_change_percent` number, required
    - `sell_24h` number, required
    - `sell_history_24h` number, required
    - `sell_24h_change_percent` number, required
    - `buy_24h` number, required
    - `buy_history_24h` number, required
    - `buy_24h_change_percent` number, required
    - `volume_24h` number, required
    - `volume_24h_usd` number, required
    - `volume_history_24h` number, required
    - `volume_history_24h_usd` number, required
    - `volume_24h_change_percent` number, required
    - `volume_buy_24h` number, required
    - `volume_buy_24h_usd` number, required
    - `volume_buy_history_24h` number, required
    - `volume_buy_history_24h_usd` number, required
    - `volume_buy_24h_change_percent` number, required
    - `volume_sell_24h` number, required
    - `volume_sell_24h_usd` number, required
    - `volume_sell_history_24h` number, required
    - `volume_sell_history_24h_usd` number, required
    - `volume_sell_24h_change_percent` number, required

## 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/versions/fcaba926a089/schema)