> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mobula.io/llms.txt
> Use this file to discover all available pages before exploring further.

# How to Track Token Markets Across Ethereum, Solana, BNB, Base & More

> Use the Token Markets endpoint to retrieve market data for a token using its contract address.

The [**Get Token Markets**](https://docs.mobula.io/rest-api-reference/endpoint/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](https://docs.mobula.io/blockchains/solana), [Ethereum](https://docs.mobula.io/blockchains/ethereum), [BNB Chain](https://docs.mobula.io/blockchains/bsc), [Base](https://docs.mobula.io/blockchains/base), and more.

***

<div style={{ position: 'relative', paddingBottom: '56.25%', height: 0, overflow: 'hidden' }}>
  <iframe src="https://www.youtube.com/embed/rNNkPrGgR5I" title="YouTube video player" style={{ position: 'absolute', top: 0, left: 0, width: '100%', height: '100%', border: 0 }} allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowFullScreen />
</div>

***

## 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](https://admin.mobula.io/)

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**](https://docs.mobula.io/rest-api-reference/endpoint/token-details)

If you need trade-level activity instead, use: [**Get Token Trades**](https://docs.mobula.io/rest-api-reference/endpoint/token-trades)

***

## Walkthrough to Get Token Markets

### 1. Prepare your query

The `token/markets` endpoint requires two parameters:

| Parameter    | Description                                                    |
| ------------ | -------------------------------------------------------------- |
| `blockchain` | Blockchain identifier (example: `evm:1`, `solana`, `ethereum`) |
| `address`    | Direct 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](https://docs.mobula.io/blockchains/solana) or [Ethereum](https://docs.mobula.io/blockchains/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](https://mobula-demo-endpoint-production.up.railway.app/)

[Token Markets Demo UI](https://mobula-demo-endpoint-production.up.railway.app/token-markets)

[Docs](https://docs.mobula.io/rest-api-reference/endpoint/token-markets)

***

## 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](https://admin.mobula.io/)