Trades - Token Seek By Time

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

{
  "success": true,
  "data": {
    "items": [
      {
        "quote": {
          "symbol": "SOL",
          "decimals": 9,
          "address": "So11111111111111111111111111111111111111112",
          "amount": "83",
          "uiAmount": 8.3e-8,
          "price": 133.58588874466795,
          "changeAmount": 83,
          "uiChangeAmount": 8.3e-8,
          "isScaledUiToken": false,
          "multiplier": null
        },
        "base": {
          "symbol": "Poppy",
          "decimals": 6,
          "address": "7Am9kVe9qymLGzLu9LnGFT6pX43DAuMYBLveSRijpump",
          "amount": "2999999",
          "uiAmount": 2.999999,
          "price": 0.000003840642989117913,
          "changeAmount": -2999999,
          "uiChangeAmount": -2.999999,
          "isScaledUiToken": false,
          "multiplier": null
        },
        "basePrice": 0.000003840642989117913,
        "quotePrice": 133.58588874466795,
        "txHash": "2rfQEtcrKmbCrwLet9REvUMWd6PoKjRV5fjUhYfmUjdS3ECkwF12s2bmswi8VGYxX1zp96nTfFxeSafjxDmASH6q",
        "source": "pump_dot_fun",
        "blockUnixTime": 1741531132,
        "txType": "swap",
        "owner": "J8RsYYa1CSsRi77aThfy48YPc7K5gwaepQDdvz2E3UoM",
        "side": "buy",
        "alias": null,
        "pricePair": 36144566.26506024,
        "from": {
          "symbol": "Poppy",
          "decimals": 6,
          "address": "7Am9kVe9qymLGzLu9LnGFT6pX43DAuMYBLveSRijpump",
          "amount": "2999999",
          "uiAmount": 2.999999,
          "price": 0.000003840642989117913,
          "changeAmount": -2999999,
          "uiChangeAmount": -2.999999,
          "isScaledUiToken": false,
          "multiplier": null
        },
        "to": {
          "symbol": "SOL",
          "decimals": 9,
          "address": "So11111111111111111111111111111111111111112",
          "amount": "83",
          "uiAmount": 8.3e-8,
          "price": 133.58588874466795,
          "changeAmount": 83,
          "uiChangeAmount": 8.3e-8,
          "isScaledUiToken": false,
          "multiplier": null
        },
        "tokenPrice": 133.58588874466795,
        "poolId": "2qPLBXMp8YvQyM1SDQ4QoYF314jcLzM86NpMUF6Wni6H"
      }
    ],
    "hasNext": true
  }
}

GET

defi

txs

token

seek_by_time

Trades - Token Seek By Time

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

{
  "success": true,
  "data": {
    "items": [
      {
        "quote": {
          "symbol": "SOL",
          "decimals": 9,
          "address": "So11111111111111111111111111111111111111112",
          "amount": "83",
          "uiAmount": 8.3e-8,
          "price": 133.58588874466795,
          "changeAmount": 83,
          "uiChangeAmount": 8.3e-8,
          "isScaledUiToken": false,
          "multiplier": null
        },
        "base": {
          "symbol": "Poppy",
          "decimals": 6,
          "address": "7Am9kVe9qymLGzLu9LnGFT6pX43DAuMYBLveSRijpump",
          "amount": "2999999",
          "uiAmount": 2.999999,
          "price": 0.000003840642989117913,
          "changeAmount": -2999999,
          "uiChangeAmount": -2.999999,
          "isScaledUiToken": false,
          "multiplier": null
        },
        "basePrice": 0.000003840642989117913,
        "quotePrice": 133.58588874466795,
        "txHash": "2rfQEtcrKmbCrwLet9REvUMWd6PoKjRV5fjUhYfmUjdS3ECkwF12s2bmswi8VGYxX1zp96nTfFxeSafjxDmASH6q",
        "source": "pump_dot_fun",
        "blockUnixTime": 1741531132,
        "txType": "swap",
        "owner": "J8RsYYa1CSsRi77aThfy48YPc7K5gwaepQDdvz2E3UoM",
        "side": "buy",
        "alias": null,
        "pricePair": 36144566.26506024,
        "from": {
          "symbol": "Poppy",
          "decimals": 6,
          "address": "7Am9kVe9qymLGzLu9LnGFT6pX43DAuMYBLveSRijpump",
          "amount": "2999999",
          "uiAmount": 2.999999,
          "price": 0.000003840642989117913,
          "changeAmount": -2999999,
          "uiChangeAmount": -2.999999,
          "isScaledUiToken": false,
          "multiplier": null
        },
        "to": {
          "symbol": "SOL",
          "decimals": 9,
          "address": "So11111111111111111111111111111111111111112",
          "amount": "83",
          "uiAmount": 8.3e-8,
          "price": 133.58588874466795,
          "changeAmount": 83,
          "uiChangeAmount": 8.3e-8,
          "isScaledUiToken": false,
          "multiplier": null
        },
        "tokenPrice": 133.58588874466795,
        "poolId": "2qPLBXMp8YvQyM1SDQ4QoYF314jcLzM86NpMUF6Wni6H"
      }
    ],
    "hasNext": true
  }
}

Usage Note
Accessibility
Chain Supported

Time-bounded legacy trade sync for one token.

Pass the token address in address.
limit supports 1 to 100 items per request, and offset supports up to 10,000.
Use before_time and after_time to step through historical windows.
Insights in the response:
price: the executed price of the trade at the exact moment the transaction occurred.
nearestPrice: the closest available market price to the transaction timestamp from Birdeye’s price index.
basePrice: the USD price of the base token at the time of the trade.
quotePrice: the USD price of the quote token at the time of the trade.

Compute Unit ⚙️

This endpoint consumes 10 CU per request.

Use Cases 💡

Fetch historical token trades starting from a specific timestamp.
Perfect for syncing trade data into your database or analytics tools.
Enables building time-based trade charts or volume trend analysis.
Combine with real-time transaction endpoints to create full trade timelines.
Great for tracking whale activity, token movements, or suspicious patterns.
Backfill token trades into a database with explicit time windows.
Reconstruct trade timelines around launches, news, or whale activity.
Build historical trade charts and flow analytics from raw events.
Continue ingestion from a known checkpoint instead of replaying the entire feed.

How to Use 🛠️

Set x-chain for the target network.
Pass the token address in address.
Use after_time and before_time to define the window you want.
Page through dense windows with offset and limit, keeping limit at 100 or below.

Best Practices ✅

Use fixed window sizes in your backfill jobs so retries and deduplication stay simple.
Treat nearestPrice as a reference price, not the executed fill price.
Switch to V3 token trades if you later need owner, source, 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

Pagination start position. offset + limit <= 10000

Required range: 0 <= x <= 10000

limit

integer

default:100

Number of items per page.

Required range: 1 <= x <= 100

tx_type

enum<string>

default:swap

Available options:

swap,

add,

remove,

all

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

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