get
https://public-api.birdeye.so/defi/txs/pair/seek_by_time
Retrieve a list of trades of a specified pair with time bound option.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Time-bounded legacy trade sync for one pair.
- Pass the pair address in
address. limitsupports1to100items per request, andoffsetsupports up to10,000.- Use
before_timeandafter_timeto step through historical pair activity. - 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.
- Lite
- Starter
- Premium
- Business
- Enterprise
All chains ⛓️ ✨
Compute Unit ⚙️
- This endpoint consumes
10 CUper request.
Use Cases 💡
- Retrieve historical trades for a specific trading pair from a given timestamp.
- Great for analyzing liquidity pool activity or pair-specific trading trends.
- Use to backfill DEX trade data for historical analysis or visualizations.
- Combine with token and pair stats for comprehensive DeFi pair insights.
- Backfill venue-specific trade history over explicit time ranges.
- Analyze pair activity during liquidity shifts, launches, or execution anomalies.
- Build pair trade archives for research, dashboards, or surveillance.
- Investigate whether one market led or lagged other venues for the same asset.
How to Use 🛠️
- Set
x-chainfor the target network. - Pass the pair address in
address. - Bound the request with
after_timeandbefore_time. - Page dense windows with
offsetandlimit, keepinglimitat100or below.
Best Practices ✅
- Use pair seek for venue forensics where one pool matters more than token-wide flow.
- Keep time windows deterministic so resumes and replays do not create gaps.
- Compare pair history with token-wide history when diagnosing cross-venue divergence.
