API Endpoints

Trades - Token (V3)

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

Retrieve a list of trades with various filters of a specified token.

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

Filtered V3 trade feed for one token.

  • Pass the token address in address.
  • limit supports 1 to 100 items per request, and offset + limit must stay within 10,000.
  • tx_type supports side-aware values such as swap, buy, sell, add, remove, and all.
  • Only one range model is allowed per request: block-time filters or block-number filters.
  • If before_time is provided, after_time is also required, and the block-time window cannot exceed 30 days.
  • If only after_time is provided with no owner, it must still be within the last 30 days.
  • If before_block_number is provided, after_block_number is also required, and block-number range cannot exceed 500,000 blocks.
  • On Solana, results may include signers, and source filtering is supported only on Solana.
Compute Unit ⚙️
  • This endpoint consumes 15 CU per request.
Use Cases 💡
  • Track the latest DEX trades for a specific token across all supported DEXes.
  • Ideal for analyzing token activity, trading momentum, or unusual volume spikes.
  • View the latest on-chain trades for a specific token.
  • Great for tracking whale activity, token movements, or suspicious patterns.
  • Analyze one token's raw trade flow with richer filtering than the legacy endpoint.
  • Separate buys, sells, swaps, and liquidity actions around a token event.
  • Investigate which wallets, pools, or venues were responsible for a move.
  • Feed token-detail pages, bots, and research pipelines with a structured V3 trade stream.
How to Use 🛠️
  • Set x-chain for the target network and pass the token address in address.
  • Filter by tx_type, owner, pool_id, and optionally source on Solana.
  • Use either time range or block-number range filters, not both.
  • Keep offset + limit <= 10000.
Best Practices ✅
  • Start with token V3 when you need explainability around who traded and where, not just that trades happened.
  • Use side-aware buy and sell filters to build cleaner flow analytics than swap-only views.
  • Join this feed with holder, wallet, and price endpoints to turn raw prints into attribution.

Query Params
string
required

The address of the token contract.

integer
0 to 9999
Defaults to 0

Make sure offset + limit <= 10000

integer
1 to 100
Defaults to 100

Number of items per page.

string
enum
Defaults to block_unix_time
Allowed:
string
enum
Defaults to desc

Specify the sort order.

Allowed:
string
enum
Defaults to swap
Allowed:
string
enum

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

string

The address of the wallet.

string

The address of the liquidity pool.

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

integer
1 to 9007199254740991

Specify the upper bound of block_number for the filter range, excluding values equal to before_block_number.

integer
1 to 9007199254740991

Specify the lower bound of block_number for the filter range, excluding values equal to after_block_number.

string
enum
Defaults to scaled

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

Allowed:
Headers
string
enum
Defaults to solana

A chain name listed in supported networks.

Responses

Updated 13 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 13 days ago

Did this page help you?