API Endpoints

Trades - Token Filtered By Volume (V3)

get
https://public-api.birdeye.so/defi/v3/token/txs-by-volume

Retrieve a list of trades with various filters of a specified token with volume (value).

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

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: 50 CU for up to 100 items, 80 CU for up to 200, and 300 CU for up to 500.
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.

Query Params
string
required

The address of the token contract.

string
enum
required

Volume type value to be filtered

Allowed:
number

Minimum volume value, support up to 3 decimals

number

Maximum volume value, support up to 3 decimals

string
enum
Defaults to block_unix_time
Allowed:
string
enum
Defaults to swap
Allowed:
string
enum

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

string

The address of the wallet.

integer
1 to 10000000000

Specify the time seeked before using unix timestamps in seconds

integer
1 to 10000000000

Specify the time seeked after using unix timestamps in seconds

string
enum
Defaults to scaled

Indicate whether to use the scaled amount for scaled ui amount tokens. Only support solana

Allowed:
string
enum
required
Defaults to desc

Specify the sort order.

Allowed:
integer
0 to 9999
Defaults to 0

Make sure offset + limit <= 10000

integer
1 to 500
Defaults to 100

Number of items per page.

Headers
string
enum
Defaults to solana

Solana network only.

Allowed:
Responses

Updated 7 days ago

Did this page help you?
Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 7 days ago

Did this page help you?