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 Testnet.

🚧

The Token Trades API on Monad is currently available to our paid Members. Free tier members can also enjoy a trial period with 30 free calls. 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!