API Reference

Retrieve Token Pools

Retrieve a list of decentralized exchange (DEX) liquidity pools associated with a specific coin. Useful for discovering which pools a coin is actively traded in, as well as retrieving relevant pool-level data such as token pair, liquidity, volume, and price.


📘

Supported on Monad Testnet.

🚧

The Token Pools 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.

Response

  • data, array - A list of liquidity pool records.
    • dex, string - Name of the decentralized exchange hosting the pool (e.g., "Bean Exchange", "Octo", "UniswapV3").
    • link, string - External link to the pool (if available).
    • poolId, string - Contract address identifier of the liquidity pool.
    • balance, string - Pool balance in human-readable format.
    • price, string - Current price of the token pair in the pool.
    • tokenList, array - List of tokens in the liquidity pool pair.
      • token, string - Token contract address.
      • decimal, integer - Number of decimal places used by the token.
      • name, string - Full name of the token.
      • symbol, string - Token symbol (e.g., "WMON", "CHOG", "USDT", "USDC").
      • image, string - URL to the token's logo image.
      • verified, boolean - Whether the token has been verified.
    • tvl, string - Total Value Locked in the pool, expressed in USD.
    • volume24H, string - Trading volume in the pool over the last 24 hours.
    • volume24HChange, string - Percentage change in 24-hour volume compared to the previous period.
    • apr, string - Annual Percentage Rate for liquidity providers (empty if not available).
    • total, integer - Total number of pools returned in the response.
Language
Credentials
Header
Click Try It! to start a request and see the response here!