Skip to main content
The Get Token Markets endpoint lets you retrieve market data for a token using its contract address. This returns market-level details like liquidity, volume, price changes, and trading activity across chains like Solana, Ethereum, BNB Chain, Base, and more.

​
What this endpoint does

With this API, you can:
  • Retrieve market information matching a token on a specific blockchain
  • Return market-level data such as liquidity, volume, price changes, and trade activity
  • Include base and quote token metadata for each market
  • Support limiting results to control how many markets are returned

​
What you’ll need

  • Basic knowledge of REST APIs
  • A token address
  • A Mobula API key
Note: All Mobula endpoints require an API key.
Get a free API key: Here Optional:
  • DexScreener (to find token addresses to test)

​
When to use Token Markets

Use this endpoint when you want to:
  • List the markets or pools where a token is trading
  • Compare liquidity across different markets for the same token
  • Track volume, trades, and price change metrics at the market level
  • Build token market pages for dashboards and analytics tools
  • Limit results to show only the top markets you care about
If you need in-depth token metadata instead, use: Get Token Details If you need trade-level activity instead, use: Get Token Trades

​
Walkthrough to Get Token Markets

​
1. Prepare your query

The token/markets endpoint requires two parameters:
ParameterDescription
blockchainBlockchain identifier (example: evm:1, solana, ethereum)
addressDirect token address
Optional parameters you can use:
  • limit: Number of markets to return (default: 10, max: 25)
Tip: Make sure you select the correct chain, such as Solana or Ethereum.

​
2. Find a token address to test

To retrieve real token market data:
  • Open DexScreener
  • Pick a token
  • Copy the token contract address from the token page
This address is used as the address parameter.

​
3. Fill the API form

Once your token address is ready:
  • Enter the blockchain value into blockchain
  • Paste the token contract into address
  • (Optional) set limit to control how many markets are returned
  • Click Send to retrieve token market data

​
Reviewing the response

Each item in data[] represents a market for the token. Key fields include:
  • base / quote: Base and quote token objects with metadata like symbol, name, decimals, and price
  • liquidityUSD: Liquidity available in the market in USD
  • latestTradeDate: Timestamp of the most recent trade observed
  • blockchain: Blockchain name for the market
  • address: Market or pool address
  • type: DEX or market type (example: Uniswap v3 style markets)
  • exchange: Exchange object with name and logo
  • priceUSD / priceToken: Market pricing fields
  • priceChange*: Price change percentages across timeframes like 1h and 24h
  • volume*: Volume metrics across timeframes like 1h, 4h, and 24h
  • trades* / buys* / sells*: Trade counts across multiple time windows
  • buyers* / sellers* / traders*: Unique participant counts
  • security: Basic security-related fields when available
  • socials: Token social links when available

​
Try It Live with Mobula Token Markets Demo (UI)

You can also test this endpoint using our demo UI: Demo UI Homepage Token Markets Demo UI Docs

​
Summary

The Get Token Markets endpoint helps you:
  • Retrieve token market data by providing blockchain and token address
  • Use limit to control how many markets are returned
  • Compare liquidity, volume, and price change stats across markets
  • Visualize results instantly in the demo UI

​
Try Mobula for Free

Try our free API today and start building in minutes.
Get your free API key: Here