Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.codex.io/llms.txt

Use this file to discover all available pages before exploring further.

​
Returns

​
Arguments

​
Usage Guidelines

  • Pass a token address or pair address to the address field; if you pass a token address, it will automatically find the top pair for that token
  • Use eventDisplayType filter to get only Buy or Sell events (splits swaps into directional trades)
  • Use eventType: Swap to filter for only swap transactions, excluding liquidity events
  • Use maker filter to get transactions for a specific wallet address
  • Use timestamp filter with from and to for historical event lookups
  • Use priceUsdTotal filter to find large trades (e.g., priceUsdTotal: {gte: 10000})
  • Results are ordered by most recent first by default; use direction: ASC for oldest first

​
Troubleshooting Tips

Use eventDisplayType instead of eventType. While eventType returns Swap for all swaps, eventDisplayType splits them into Buy or Sell based on the direction of the trade relative to the quote token.
Add eventType: Swap to your query filters to exclude liquidity add/remove events. Alternatively, use eventDisplayType: [Buy, Sell] to get only buy and sell events.
Use the timestamp filter with from and to unix timestamps. For example: timestamp: {from: 1704067200, to: 1704153600} for a 24-hour window.
priceUsd is the price per token at the time of the swap. priceUsdTotal is the total USD value of the swap (amountNonLiquidityToken x priceUsd). Use priceUsdTotal for filtering by trade size.
Check the labels field on events. It contains sandwich labels (with types sandwiched, frontrun, backrun) and washtrade labels when detected.
getTokenEvents looks at the top pair when filtering for events, not all pairs. If the missing transactions occurred on a different pair, use listPairsWithMetadataForToken to find the correct pool (filter by volume) and pass that pair address to getTokenEvents.
  • Detailed Token Page: Build a comprehensive token detail page with price, holders, trades, and real-time updates
  • Events: Build a token swap list with filtering, pagination, and real-time updates