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

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!