Trader - Trades Seek By Time

curl --request GET \
  --url https://public-api.birdeye.so/trader/txs/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/trader/txs/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": 8791828613200,
          "type": "split",
          "type_swap": "to",
          "ui_amount": 8791.8286132,
          "price": 182.32478738013168,
          "nearest_price": 182.32478738013168,
          "change_amount": 8791828613200,
          "ui_change_amount": 8791.8286132,
          "is_scaled_ui_token": false,
          "multiplier": null
        },
        "base": {
          "symbol": "BNSOL",
          "decimals": 9,
          "address": "BNso1VUJnh4zcfpZa6986Ea66P6TCp59hvtNJ8b1X85",
          "amount": 8243057055060,
          "type": "burn",
          "type_swap": "from",
          "ui_amount": 8243.05705506,
          "price": 195.07266605796318,
          "nearest_price": 195.07266605796318,
          "change_amount": -8243057055060,
          "ui_change_amount": -8243.05705506,
          "is_scaled_ui_token": false,
          "multiplier": null
        },
        "base_price": 195.07266605796318,
        "quote_price": 182.32478738013168,
        "tx_hash": "3tiVFmNkAzesSgJ8RJfRMFSMSTGMbvVd8Qm23uroSCPQFSi6rqhr9tqCCRCu4nZD8u3jLVMcuh3qxmEzFnbS61rF",
        "source": "stake_pool",
        "block_unix_time": 1754870741,
        "tx_type": "swap",
        "address": "Hr9pzexrBge3vgmBNRR8u42CNQgBXdHm4UkUN2DH4a7r",
        "owner": "GBJ4MZe8fqpA6UVgjh19BwJPMb79KDfMv78XnFVxgH2Q",
        "block_number": 359226070,
        "volume_usd": 1602968.2825842479,
        "volume": 8243.05705506,
        "ins_index": 2,
        "inner_ins_index": 0,
        "signers": [
          "GBJ4MZe8fqpA6UVgjh19BwJPMb79KDfMv78XnFVxgH2Q",
          "5Z4RXtFUSBzQeptBRxBT4PHFMdMqgTt6YXNwEgngcSQ7"
        ],
        "interacted_program_id": "bn1dUNRecofQLxcGp895mGmKEVtFLMjdvjxBjFqhFU7"
      }
    ],
    "hasNext": true
  }
}

GET

trader

txs

seek_by_time

Trader - Trades Seek By Time

curl --request GET \
  --url https://public-api.birdeye.so/trader/txs/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/trader/txs/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": 8791828613200,
          "type": "split",
          "type_swap": "to",
          "ui_amount": 8791.8286132,
          "price": 182.32478738013168,
          "nearest_price": 182.32478738013168,
          "change_amount": 8791828613200,
          "ui_change_amount": 8791.8286132,
          "is_scaled_ui_token": false,
          "multiplier": null
        },
        "base": {
          "symbol": "BNSOL",
          "decimals": 9,
          "address": "BNso1VUJnh4zcfpZa6986Ea66P6TCp59hvtNJ8b1X85",
          "amount": 8243057055060,
          "type": "burn",
          "type_swap": "from",
          "ui_amount": 8243.05705506,
          "price": 195.07266605796318,
          "nearest_price": 195.07266605796318,
          "change_amount": -8243057055060,
          "ui_change_amount": -8243.05705506,
          "is_scaled_ui_token": false,
          "multiplier": null
        },
        "base_price": 195.07266605796318,
        "quote_price": 182.32478738013168,
        "tx_hash": "3tiVFmNkAzesSgJ8RJfRMFSMSTGMbvVd8Qm23uroSCPQFSi6rqhr9tqCCRCu4nZD8u3jLVMcuh3qxmEzFnbS61rF",
        "source": "stake_pool",
        "block_unix_time": 1754870741,
        "tx_type": "swap",
        "address": "Hr9pzexrBge3vgmBNRR8u42CNQgBXdHm4UkUN2DH4a7r",
        "owner": "GBJ4MZe8fqpA6UVgjh19BwJPMb79KDfMv78XnFVxgH2Q",
        "block_number": 359226070,
        "volume_usd": 1602968.2825842479,
        "volume": 8243.05705506,
        "ins_index": 2,
        "inner_ins_index": 0,
        "signers": [
          "GBJ4MZe8fqpA6UVgjh19BwJPMb79KDfMv78XnFVxgH2Q",
          "5Z4RXtFUSBzQeptBRxBT4PHFMdMqgTt6YXNwEgngcSQ7"
        ],
        "interacted_program_id": "bn1dUNRecofQLxcGp895mGmKEVtFLMjdvjxBjFqhFU7"
      }
    ],
    "hasNext": true
  }
}

Usage Note
Accessibility
Chain Supported

Time-bounded trade history for one trader wallet.

Pass the trader wallet in address.
limit supports 1 to 100 items per request.
Use before_time and after_time to retrieve wallet trade activity over a chosen window.
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 💡

Retrieve historical trades for a specific trader from a given timestamp.
Useful for trader behavior analysis, execution review, and wallet-level flow reconstruction.
Great for tracking whale activity, token movements, or suspicious patterns.
Reconstruct a wallet’s trading timeline over a specific period.
Review whether a trader accumulated, flipped, or exited around a market event.
Backfill trader-centric execution data into performance or behavior models.
Investigate how one wallet’s trade path aligned with token or market-level moves.

How to Use 🛠️

Set x-chain for the target network.
Pass the trader wallet in address.
Bound the query with after_time and before_time.
Page with offset and limit, keeping limit at 100 or below.

Best Practices ✅

Use deterministic time windows for trader backfills so retries and deduplication stay clean.
Join the wallet’s trades with holder, PnL, or token-level trade views when investigating attribution.
Treat nearestPrice as reference context and price as the actual executed trade price.

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 a trader.

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>

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 trader

success

boolean

required

Whether the request succeeded.

data

object

required

Show child attributes