API Endpoints

Trades - Recent (V3)

get
https://public-api.birdeye.so/defi/v3/txs/recent

Retrieve a list of recent trades.

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

Latest V3 trade feed on one chain.

  • This endpoint is optimized for freshness rather than deep archival queries.
  • limit supports 1 to 500 items per request, and offset + limit must stay within 10,000.
  • You may filter by time or block-number window, but only one range model is allowed per request.
  • sort_by is selected automatically from the range filter you use, and sort order is descending.
  • tx_type supports side-aware values such as buy and sell.
  • On Solana, ui_amount_mode can switch between raw and scaled; other chains are normalized to scaled.
Compute Unit ⚙️
  • CU is dynamic: 25 CU for up to 100 items, 75 CU for up to 300, and 125 CU for up to 500.
Use Cases 💡
  • Get recent DEX trades across all tokens and pairs on a specific chain.
  • Great for tracking whale activity, token movements, or suspicious patterns.
  • Drive the freshest trade feed for dashboards, monitors, and alert pipelines.
  • Watch a chain for sudden buy, sell, or swap bursts in near real time.
  • Build recent-flow widgets before deciding which tokens deserve deeper analysis.
  • Feed streaming-like polling systems when WebSocket is not the chosen integration.
How to Use 🛠️
  • Set x-chain for the target network.
  • Use tx_type and optional owner filters to shape the recent feed.
  • Optionally narrow by recent time or block range, but do not mix both.
  • Keep the request under the 10,000 total record cap from offset + limit.
Best Practices ✅
  • Poll on a steady cadence and deduplicate by transaction identifiers in your consumer.
  • Keep limits as low as the UI or job can tolerate so CU stays efficient.
  • Use this endpoint for freshness, then hand off to Trades - All (V3) or token-specific endpoints for deeper backfills.

Query Params
integer
0 to 9999
Defaults to 0

Make sure offset + limit <= 10000

integer
1 to 500
Defaults to 100

Number of items per page.

string
enum
Defaults to swap
Allowed:
string

The address of the wallet.

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

integer
1 to 9007199254740991

Specify the upper bound of block_number for the filter range, excluding values equal to before_block_number.

integer
1 to 9007199254740991

Specify the lower bound of block_number for the filter range, excluding values equal to after_block_number.

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 13 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 13 days ago

Did this page help you?