API Reference

Retrieve Token Trades

Retrieve a paginated list of token trades from the decentralized exchange (DEX). Each record contains detailed information about the swap.

📘

Supported on Monad Mainnet and Testnet.

🚧

The Monad Mainnet Indexing API is available to Pro tier users. The Monad Testnet Indexing API is accessible to Pro, Basic, and Lite tiers. Free tier members can also enjoy a trial period with 30 free calls. The same request URL is used for both mainnet and testnet. Network selection is handled automatically through the API key.

If you're interested, please register directly through here. Please note that the API Key can also be used for your RPC endpoint.


Parameter

  • contractAddress, string- a 42 character address with '0x' as prefix. The on-chain address of the token’s smart contract.
  • sender, string, - address of the trade sender.
  • type, string, - trade type or action descriptor (e.g., "buy,sell").
  • cursor, string - next page cursor.
  • limit, integer - the maximum number of results to return per page. Defaults to 20, maximum is 50.

Response

  • data, array - A list of trading transaction records.
    • txHash, string - Transaction hash, unique identifier on the blockchain.
    • sender, string - Wallet address of the user who initiated the transaction.
    • type, string - Type of transaction, either "buy" or "sell".
    • dex, string - Name of the decentralized exchange where the transaction took place (e.g., "Octo", "UniswapV3", "Bean Exchange").
    • timestamp, integer - Unix timestamp in seconds when the transaction occurred.
    • poolAddress, string - Contract address of the liquidity pool used for the swap.
    • price, string - The effective price of the trade, calculated from token amounts.
    • token0Info, object - Detailed information about the first token in the pair.
      • token, string - Token contract address.
      • amount, string - Token amount in human-readable format (decimals applied).
      • amountUSD, string - USD value equivalent of the token amount.
      • decimal, integer - Number of decimal places used by the token.
      • name, string - Full name of the token.
      • symbol, string - Token symbol (e.g., "CHOG", "WMON", "WETH").
      • image, string - URL to the token's logo image.
      • verified, boolean - Whether the token has been verified.
    • token1Info, object - Detailed information about the second token in the pair, with the same structure as token0Info.
      • token, string - Token contract address.
      • amount, string - Token amount in human-readable format (decimals applied).
      • amountUSD, string - USD value equivalent of the token amount.
      • decimal, integer - Number of decimal places used by the token.
      • name, string - Full name of the token.
      • symbol, string - Token symbol.
      • image, string - URL to the token's logo image.
      • verified, boolean - Whether the token has been verified.
    • nextPageCursor, integer - Cursor used for paginating to the next page of results.
Language
Credentials
Header
Click Try It! to start a request and see the response here!