Trades - Token Seek By Time

Time	Status	User Agent
Retrieving recent requests…

Time

Status

User Agent

Retrieving recent requests…

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 ⚙️

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.

200JSON object containing transactions of a token