Trades - Token (V3)

curl --request GET \
  --url https://public-api.birdeye.so/defi/v3/token/txs \
  --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', 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

Trades - Token (V3)

curl --request GET \
  --url https://public-api.birdeye.so/defi/v3/token/txs \
  --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', 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

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 12 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.

Authorizations

X-API-KEY

string

header

required

API key for authentication

Headers

x-chain

enum<string>

default:solana

A chain name listed in supported networks.

Available options:

solana,

ethereum,

bsc,

base,

robinhood,

sui,

mantle,

hyperevm,

arbitrum,

avalanche,

optimism,

polygon,

zksync,

monad,

aptos,

fogo,

megaeth

Query Parameters

address

string

required

The address of the token contract.

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 <= 100

sort_by

enum<string>

default:block_unix_time

Available options:

block_unix_time,

block_number

sort_type

enum<string>

default:desc

Specify the sort order.

Available options:

desc

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.

pool_id

string

The address of the liquidity pool.

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

before_block_number

integer

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

Required range: 1 <= x <= 9007199254740991

after_block_number

integer

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

Required range: 1 <= x <= 9007199254740991

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

Response

JSON object containing transactions of a token

success

boolean

required

Whether the request succeeded.

data

object

required

Show child attributes