Trades - 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
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Time-bounded legacy trade sync for one pair.

  • Pass the pair 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 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.
Compute Unit ⚙️
  • This endpoint consumes 10 CU per 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-chain for the target network.
  • Pass the pair address in address.
  • Bound the request with after_time and before_time.
  • Page dense windows with offset and limit, keeping limit at 100 or 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.

Query Params
string
required

The address of a pair contract

integer
0 to 10000
Defaults to 0

Pagination start position. offset + limit <= 10000

integer
1 to 50
Defaults to 50

Number of items per page.

string
enum
Defaults to swap
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

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