Trades - Token

curl --request GET \
  --url https://public-api.birdeye.so/defi/txs/token \
  --header 'X-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://public-api.birdeye.so/defi/txs/token', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "data": {
    "items": [
      {
        "quote": {
          "symbol": "SHIPE",
          "decimals": 6,
          "address": "9K78h3XEb7qqRu4XEaAEhe3qXaAeN1XyHa65bLwKXaNp",
          "amount": 3000940514830,
          "uiAmount": 3000940.51483,
          "price": 0.00008920248678973954,
          "nearestPrice": 0.00008879906452142359,
          "changeAmount": 3000940514830,
          "uiChangeAmount": 3000940.51483,
          "isScaledUiToken": false,
          "multiplier": null
        },
        "base": {
          "symbol": "SOL",
          "decimals": 9,
          "address": "So11111111111111111111111111111111111111112",
          "amount": 1452043321,
          "uiAmount": 1.452043321,
          "price": 184.35493814782487,
          "nearestPrice": 184.35493814782487,
          "changeAmount": -1452043321,
          "uiChangeAmount": -1.452043321,
          "isScaledUiToken": false,
          "multiplier": null
        },
        "basePrice": 184.35493814782487,
        "quotePrice": 0.00008920248678973954,
        "txHash": "NLiBctRYuhibKZCJPkPxGhDKi9pCo2fx818H1UBJ82gD5DKddvufzf5DAPVKkLgejQ4EezcgE72FUrf327VQGaV",
        "source": "pump_amm",
        "blockUnixTime": 1754883867,
        "txType": "swap",
        "owner": "5V7aauQjnizwXAPGcJnjC7mbpenbiQZBfBSxW3n7NGCD",
        "side": "sell",
        "alias": null,
        "pricePair": 2066701.7790924432,
        "from": {
          "symbol": "SOL",
          "decimals": 9,
          "address": "So11111111111111111111111111111111111111112",
          "amount": 1452043321,
          "uiAmount": 1.452043321,
          "price": 184.35493814782487,
          "nearestPrice": 184.35493814782487,
          "changeAmount": -1452043321,
          "uiChangeAmount": -1.452043321,
          "isScaledUiToken": false,
          "multiplier": null
        },
        "to": {
          "symbol": "SHIPE",
          "decimals": 6,
          "address": "9K78h3XEb7qqRu4XEaAEhe3qXaAeN1XyHa65bLwKXaNp",
          "amount": 3000940514830,
          "uiAmount": 3000940.51483,
          "price": 0.00008920248678973954,
          "nearestPrice": 0.00008879906452142359,
          "changeAmount": 3000940514830,
          "uiChangeAmount": 3000940.51483,
          "isScaledUiToken": false,
          "multiplier": null
        },
        "tokenPrice": 184.35493814782487,
        "poolId": "7LfK73yHk16kaSqa4FDB8t1oU445zzSsgMMC3at4eCFR"
      }
    ],
    "hasNext": true
  }
}

GET

defi

txs

token

Trades - Token

curl --request GET \
  --url https://public-api.birdeye.so/defi/txs/token \
  --header 'X-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://public-api.birdeye.so/defi/txs/token', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "data": {
    "items": [
      {
        "quote": {
          "symbol": "SHIPE",
          "decimals": 6,
          "address": "9K78h3XEb7qqRu4XEaAEhe3qXaAeN1XyHa65bLwKXaNp",
          "amount": 3000940514830,
          "uiAmount": 3000940.51483,
          "price": 0.00008920248678973954,
          "nearestPrice": 0.00008879906452142359,
          "changeAmount": 3000940514830,
          "uiChangeAmount": 3000940.51483,
          "isScaledUiToken": false,
          "multiplier": null
        },
        "base": {
          "symbol": "SOL",
          "decimals": 9,
          "address": "So11111111111111111111111111111111111111112",
          "amount": 1452043321,
          "uiAmount": 1.452043321,
          "price": 184.35493814782487,
          "nearestPrice": 184.35493814782487,
          "changeAmount": -1452043321,
          "uiChangeAmount": -1.452043321,
          "isScaledUiToken": false,
          "multiplier": null
        },
        "basePrice": 184.35493814782487,
        "quotePrice": 0.00008920248678973954,
        "txHash": "NLiBctRYuhibKZCJPkPxGhDKi9pCo2fx818H1UBJ82gD5DKddvufzf5DAPVKkLgejQ4EezcgE72FUrf327VQGaV",
        "source": "pump_amm",
        "blockUnixTime": 1754883867,
        "txType": "swap",
        "owner": "5V7aauQjnizwXAPGcJnjC7mbpenbiQZBfBSxW3n7NGCD",
        "side": "sell",
        "alias": null,
        "pricePair": 2066701.7790924432,
        "from": {
          "symbol": "SOL",
          "decimals": 9,
          "address": "So11111111111111111111111111111111111111112",
          "amount": 1452043321,
          "uiAmount": 1.452043321,
          "price": 184.35493814782487,
          "nearestPrice": 184.35493814782487,
          "changeAmount": -1452043321,
          "uiChangeAmount": -1.452043321,
          "isScaledUiToken": false,
          "multiplier": null
        },
        "to": {
          "symbol": "SHIPE",
          "decimals": 6,
          "address": "9K78h3XEb7qqRu4XEaAEhe3qXaAeN1XyHa65bLwKXaNp",
          "amount": 3000940514830,
          "uiAmount": 3000940.51483,
          "price": 0.00008920248678973954,
          "nearestPrice": 0.00008879906452142359,
          "changeAmount": 3000940514830,
          "uiChangeAmount": 3000940.51483,
          "isScaledUiToken": false,
          "multiplier": null
        },
        "tokenPrice": 184.35493814782487,
        "poolId": "7LfK73yHk16kaSqa4FDB8t1oU445zzSsgMMC3at4eCFR"
      }
    ],
    "hasNext": true
  }
}

Usage Note
Accessibility
Chain Supported

Legacy trade list for one token.

Pass the token address in address.
limit supports 1 to 50 items per request, and offset supports up to 50,000.
tx_type defaults to swap and can also be used to inspect liquidity actions such as add and remove.
ui_amount_mode controls Solana Token-2022 scaled amounts; on non-Solana chains it is normalized to scaled.
Use descending sort when you want the most recent trades first.

Compute Unit ⚙️

This endpoint consumes 10 CU per request.

Use Cases 💡

View the latest on-chain trades for a specific token.
Great for tracking whale activity, token movements, or suspicious patterns.
Show the latest on-chain trades for a token on a detail page or monitoring dashboard.
Inspect swaps and liquidity actions around launches, pumps, or distribution events.
Build compact trade tapes without the heavier V3 filtering model.
Join recent trades with price and holder data for quick market context.

How to Use 🛠️

Set x-chain for the target network.
Pass the token address in address.
Page with offset and limit, keeping limit at 50 or below.
Use tx_type to focus on swaps or liquidity actions.

Best Practices ✅

Use descending sort when the UI is meant to show the newest activity first.
Keep pagination windows small on very active tokens so refreshes stay responsive.
Move to Trades - Token (V3) when you need owner, source, pool, or block-range filters.

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:50

Number of items per page.

Required range: 1 <= x <= 50

tx_type

enum<string>

default:swap

Available options:

swap,

add,

remove,

all

sort_type

enum<string>

default:desc

required

Specify the sort order.

Available options:

desc,

asc

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