---
title: "Token - Top traders"
method: GET
path: "/defi/v2/tokens/top_traders"
tags: ["Wallet, Networth & PnL"]
---

# Token - Top traders

`GET /defi/v2/tokens/top_traders`

Rank the top trader trading a token by volume, trade count, PnL, USD volume, or Solana holder position metrics. On Solana, the response can include wallet tags, current holding stats, average buy/sell prices, first and last trade time, and optional holder net worth and funding details.

## Query parameters

- `address` string, required
- `time_frame` '30m' | '1h' | '2h' | '4h' | '6h' | '8h' | '12h' | '24h' | '2d' | '3d' | '7d' | '14d' | '30d' | '60d' | '90d' | 'all_time', required
- `sort_type` 'desc' | 'asc', required
- `sort_by` 'volume' | 'trade' | 'total_pnl' | 'unrealized_pnl' | 'realized_pnl' | 'volume_usd' | 'hold_volume', required
- `offset` integer
- `limit` integer
- `ui_amount_mode` 'raw' | 'scaled'
- `wallet_tags` string[]
- `get_holders_networth` boolean

## 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 a list of top traded tokens

- DefiTokenTopTradedResponse
  - `success` boolean, required
  - `data` object, required
    - `items` object[]
      - `tokenAddress` string
      - `owner` string
      - `tags` unknown[]
        - unknown
      - `type` string
      - `volume` number
      - `trade` integer
      - `tradeBuy` integer
      - `tradeSell` integer
      - `volumeBuy` number
      - `volumeSell` number
      - `volumeBuyUSD` number
      - `volumeSellUSD` number
      - `volumeUsd` number
      - `totalPnl` number
      - `unrealizedPnl` number
      - `realizedPnl` number
      - `holdVolume` number
      - `holdVolumeUsd` number
      - `holdAvgPrice` number
      - `avgBuyPrice` number
      - `avgSellPrice` number
      - `firstTradeUnixTime` number
      - `lastTradeUnixTime` number
      - `netWorth` number
      - `solBalance` number
      - `funding` object
        - `funder` string
        - `unixTime` number
        - `amount` number
        - `txHash` string

## 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)