Trades - All (V3)

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

{
  "success": true,
  "data": {
    "items": [
      {
        "base": {
          "symbol": "CLIPPY",
          "address": "GCLTmivKZfxYi8SV17FrpqH8HZtJauoePQPRHxJxBAGS",
          "decimals": 9,
          "price": 0.00026036603447282113,
          "amount": "24285885836773",
          "ui_amount": 24285.885836773,
          "ui_change_amount": 24285.885836773,
          "type_swap": "to",
          "is_scaled_ui_token": false,
          "multiplier": null
        },
        "quote": {
          "symbol": "SOL",
          "address": "So11111111111111111111111111111111111111112",
          "decimals": 9,
          "price": 185.6186502639611,
          "amount": "34118151",
          "ui_amount": 0.034118151,
          "ui_change_amount": -0.034118151,
          "type_swap": "from",
          "is_scaled_ui_token": false,
          "multiplier": null
        },
        "tx_type": "swap",
        "tx_hash": "4z62PXFvbo52qY66XAMhsaKSfNH9MoBinFQtsjoZcjRTc2gCGP2o86yTUdaHpnYozHxNkiATX3KRGPfFb7CyjoPW",
        "ins_index": 0,
        "inner_ins_index": 3,
        "block_unix_time": 1754885184,
        "block_number": 359262879,
        "volume_usd": 6.332965138122014,
        "volume": 24285.885836773,
        "owner": "7dGrdJRYtsNR8UYxZ3TnifXGjGc9eRYLq9sELwYpuuUu",
        "signers": [
          "7dGrdJRYtsNR8UYxZ3TnifXGjGc9eRYLq9sELwYpuuUu"
        ],
        "source": "meteora_dlmm",
        "interacted_program_id": "King7ki4SKMBPb3iupnQwTyjsq294jaXsgLmJo8cb7T",
        "pool_id": "6LR2pDMBbYZNhj1iF86b4X5zRYyX7BNrhpzRDEZYNam9"
      }
    ],
    "hasNext": true
  }
}

GET

defi

txs

Trades - All (V3)

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

{
  "success": true,
  "data": {
    "items": [
      {
        "base": {
          "symbol": "CLIPPY",
          "address": "GCLTmivKZfxYi8SV17FrpqH8HZtJauoePQPRHxJxBAGS",
          "decimals": 9,
          "price": 0.00026036603447282113,
          "amount": "24285885836773",
          "ui_amount": 24285.885836773,
          "ui_change_amount": 24285.885836773,
          "type_swap": "to",
          "is_scaled_ui_token": false,
          "multiplier": null
        },
        "quote": {
          "symbol": "SOL",
          "address": "So11111111111111111111111111111111111111112",
          "decimals": 9,
          "price": 185.6186502639611,
          "amount": "34118151",
          "ui_amount": 0.034118151,
          "ui_change_amount": -0.034118151,
          "type_swap": "from",
          "is_scaled_ui_token": false,
          "multiplier": null
        },
        "tx_type": "swap",
        "tx_hash": "4z62PXFvbo52qY66XAMhsaKSfNH9MoBinFQtsjoZcjRTc2gCGP2o86yTUdaHpnYozHxNkiATX3KRGPfFb7CyjoPW",
        "ins_index": 0,
        "inner_ins_index": 3,
        "block_unix_time": 1754885184,
        "block_number": 359262879,
        "volume_usd": 6.332965138122014,
        "volume": 24285.885836773,
        "owner": "7dGrdJRYtsNR8UYxZ3TnifXGjGc9eRYLq9sELwYpuuUu",
        "signers": [
          "7dGrdJRYtsNR8UYxZ3TnifXGjGc9eRYLq9sELwYpuuUu"
        ],
        "source": "meteora_dlmm",
        "interacted_program_id": "King7ki4SKMBPb3iupnQwTyjsq294jaXsgLmJo8cb7T",
        "pool_id": "6LR2pDMBbYZNhj1iF86b4X5zRYyX7BNrhpzRDEZYNam9"
      }
    ],
    "hasNext": true
  }
}

Usage Note
Accessibility
Chain Supported

Filtered V3 trade feed across the whole chain.

limit supports 1 to 100 items per request, and offset + limit must stay within 10,000.
Solana notes:
Transaction data includes signers — a list of accounts that authorize the transaction with their signatures.
If time range and block number range are not provided:
If sort_by = block_unix_time, default to fetching swaps within the last 7 days.
If sort_by = block_number, default to fetching swaps within the last 500,000 blocks.
Only one type of filter is accepted: either block time range or block number range.
If filtering by block time (after_time, before_time), only allow sorting by block_unix_time.
If filtering by block number (after_block_number, before_block_number), only allow sorting by block_number.
Constraints:
Block time range cannot exceed 30 days.
Block number range cannot exceed 500,000 blocks.
If only after_time is provided with no before_time, it must be within the last 30 days.
If only after_block_number is provided with no before_block_number, it must be within the most recent 500,000 blocks.
If source is used, it is supported on Solana only.
sort_type is descending-only in V3 trade endpoints.

Compute Unit ⚙️

This endpoint consumes 12 CU per request.

Use Cases 💡

Get recent DEX trades across all tokens and pairs on a specific chain.
Great for tracking whale activity, token movements, or suspicious patterns.
Build filtered chain-wide trade feeds across tokens, pools, owners, or DEX sources.
Investigate bursts of activity around a wallet, venue, or block range.
Power analytics pipelines that need raw trades beyond a single token or pair.
Detect chain-wide market flow patterns before summarizing them into dashboards or alerts.

How to Use 🛠️

Set x-chain for the target network.
Filter by tx_type, owner, pool_id, source, and either time range or block-number range.
Use sort_by=block_unix_time for time windows and sort_by=block_number for block windows.
Keep offset + limit <= 10000.

Best Practices ✅

Use block ranges when you care about precise chain progression and time ranges when you care about wall-clock windows.
Do not mix time and block filters in the same request; split them into separate jobs if needed.
On non-Solana chains, omit source and rely on other filters instead.

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

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,

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 trades

success

boolean

required

Whether the request succeeded.

data

object

required

Show child attributes