Trades - Token Filtered By Volume (V3)

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

{
  "data": {
    "items": [
      {
        "tx_type": "buy",
        "tx_hash": "3fqsirN8vbhBLHS2cVAaCXTdsCcCua75LgcBX6Z2G2yupM9cDEsmo2TP5AhXvEUBZ91xyy3KWiuDdHxoFVnp1R88",
        "ins_index": 2,
        "inner_ins_index": 0,
        "block_unix_time": 1740380278,
        "block_number": 322728531,
        "volume_usd": 0.0005729458359923133,
        "volume": 1733.23946,
        "owner": "8bP4FJNXwN5Q4a6EybtHwsiAnxFFWb93sY38mYdo6Pr2",
        "signers": [
          "8bP4FJNXwN5Q4a6EybtHwsiAnxFFWb93sY38mYdo6Pr2"
        ],
        "source": "raydium",
        "side": "buy",
        "alias": null,
        "price_pair": 486318591.4702581,
        "from": {
          "symbol": "PEPEAI",
          "address": "7nM97F8takLArrKLJdT62L54jTtX1e7h7qPSjtBrsMQA",
          "decimals": 6,
          "price": 3.5071289483955604e-7,
          "amount": "1733239460",
          "ui_amount": 1733.23946,
          "ui_change_amount": -1733.23946
        },
        "to": {
          "symbol": "SOL",
          "address": "So11111111111111111111111111111111111111112",
          "decimals": 9,
          "price": 160.7592132413898,
          "amount": "3564",
          "ui_amount": 0.000003564,
          "ui_change_amount": 0.000003564
        },
        "pool_id": "8aTXVUjPcUSwSLAbUegaKTQdB6SaNosSKQkURvpbLCNC"
      }
    ],
    "has_next": true
  },
  "success": true
}

GET

defi

token

txs-by-volume

Trades - Token Filtered By Volume (V3)

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

{
  "data": {
    "items": [
      {
        "tx_type": "buy",
        "tx_hash": "3fqsirN8vbhBLHS2cVAaCXTdsCcCua75LgcBX6Z2G2yupM9cDEsmo2TP5AhXvEUBZ91xyy3KWiuDdHxoFVnp1R88",
        "ins_index": 2,
        "inner_ins_index": 0,
        "block_unix_time": 1740380278,
        "block_number": 322728531,
        "volume_usd": 0.0005729458359923133,
        "volume": 1733.23946,
        "owner": "8bP4FJNXwN5Q4a6EybtHwsiAnxFFWb93sY38mYdo6Pr2",
        "signers": [
          "8bP4FJNXwN5Q4a6EybtHwsiAnxFFWb93sY38mYdo6Pr2"
        ],
        "source": "raydium",
        "side": "buy",
        "alias": null,
        "price_pair": 486318591.4702581,
        "from": {
          "symbol": "PEPEAI",
          "address": "7nM97F8takLArrKLJdT62L54jTtX1e7h7qPSjtBrsMQA",
          "decimals": 6,
          "price": 3.5071289483955604e-7,
          "amount": "1733239460",
          "ui_amount": 1733.23946,
          "ui_change_amount": -1733.23946
        },
        "to": {
          "symbol": "SOL",
          "address": "So11111111111111111111111111111111111111112",
          "decimals": 9,
          "price": 160.7592132413898,
          "amount": "3564",
          "ui_amount": 0.000003564,
          "ui_change_amount": 0.000003564
        },
        "pool_id": "8aTXVUjPcUSwSLAbUegaKTQdB6SaNosSKQkURvpbLCNC"
      }
    ],
    "has_next": true
  },
  "success": true
}

Usage Note
Accessibility
Chain Supported

Large-trade filter for one token.

This endpoint is Solana-only.
Pass the token mint in token_address.
limit supports up to 500 items per request.
volume_type lets you filter by USD value or token amount.
If min_volume is provided without max_volume, the backend expands max_volume automatically for an open-ended upper bound.

Compute Unit ⚙️

CU is dynamic: 40 CU for up to 100 items, 80 CU for up to 200 items, and 200 CU for up to 500 items.

Use Cases 💡

Isolate larger prints to study whale behavior, distribution, or accumulation.
Great for tracking whale activity, token movements, or suspicious patterns.
Build large-trade monitors and alert systems for one token.
Filter out micro-noise when only meaningful size matters for your analysis.
Examine whether outsized volume came from one owner, one venue, or one side of the market.

How to Use 🛠️

Set x-chain=solana.
Pass token_address and choose volume_type.
Use min_volume and optional max_volume to define the size bucket.
Add owner, tx_type, source, and recent time filters as needed.

Best Practices ✅

Define separate bands for medium and very large prints so your dashboards can distinguish accumulation from exceptional blocks.
Use USD mode when comparing across tokens and amount mode when the token quantity itself matters.
Pair this endpoint with holder and wallet endpoints when you need to identify whether repeated large prints belong to the same actor.

Limitations ⚠️

Solana only.

Authorizations

X-API-KEY

string

header

required

API key for authentication

Headers

x-chain

enum<string>

default:solana

Solana network only.

Available options:

solana

Query Parameters

token_address

string

required

The address of the token contract.

volume_type

enum<string>

required

Volume type value to be filtered

Available options:

usd,

amount

min_volume

number

Minimum volume value, support up to 3 decimals

max_volume

number

Maximum volume value, support up to 3 decimals

sort_by

enum<string>

default:block_unix_time

Available options:

block_unix_time,

block_number

tx_type

enum<string>

default:swap

Available options:

swap,

buy,

sell,

add,

remove,

all

source

enum<string>

Source of the liquidity (AMMs). Only support solana.

Available options:

raydium,

raydium_clamm,

raydium_cp,

orca,

lifinity,

fluxbeam,

saber,

phoenix,

bonkswap,

meteora_dlmm,

pump_amm,

humidifi,

bisonfi,

solfi_v2,

alphaq,

aquifer,

solfi,

whirlpool,

goonfi,

goonfi_v2,

tesserav,

jupiterz,

vertigo,

pump_dot_fun,

raydium_launchlab,

meteora_virtual_curve,

meteora_dynamic_bonding_curve

owner

string

The address of the wallet.

before_time

integer

Specify the time seeked before using unix timestamps in seconds

Required range: 1 <= x <= 10000000000

after_time

integer

Specify the time seeked after using unix timestamps in seconds

Required range: 1 <= x <= 10000000000

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

sort_type

enum<string>

default:desc

required

Specify the sort order.

Available options:

desc,

asc

offset

integer

default:0

Make sure offset + limit <= 10000

Required range: 0 <= x <= 9999

limit

integer

default:100

Number of items per page.

Required range: 1 <= x <= 500

Response

JSON object containing transactions of a token

success

boolean

required

Whether the request succeeded.

data

object

required

Show child attributes