API Endpoints

Trader - Trades Seek By Time

get
https://public-api.birdeye.so/trader/txs/seek_by_time

Retrieve a list of trades of a trader with time bound option.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

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.

Query Params
string
required

The address of a trader.

integer
0 to 10000
Defaults to 0

Pagination start position. offset + limit <= 10000

integer
1 to 100
Defaults to 100

Number of items per page.

string
enum
Allowed:
integer
1 to 10000000000

Specify the time seeked before using unix timestamps in seconds

integer
1 to 10000000000

Specify the time seeked after using unix timestamps in seconds

string
enum
Defaults to scaled

Indicate whether to use the scaled amount for scaled ui amount tokens. Only support solana

Allowed:
Headers
string
enum
Defaults to solana

A chain name listed in supported networks.

Responses

Updated 15 days ago

Did this page help you?
Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 15 days ago

Did this page help you?