> ## 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 Market Details Across Ethereum, Solana, BNB, Base & More

> Use the Market Details endpoint to retrieve market information for a specific pool or token address.

The [**Get Market Details**](https://docs.mobula.io/rest-api-reference/endpoint/market-details) endpoint lets you retrieve market information for a specific pool or token address.

This includes 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/exu2OuDKliM" 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 detailed market information for a specific pool or token address
* Return base and quote token metadata plus market-level metrics
* Include liquidity, volume, price changes, and trade activity across multiple timeframes
* Support multi-currency output using the `currencies` parameter
* Support batch queries via POST for fetching multiple markets in one request

***

## What you’ll need

* Basic knowledge of REST APIs
* A pool 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 pool addresses to test)

***

## When to use Market Details

Use this endpoint when you want to:

* Display detailed pool or pair metrics for a DEX market page
* Monitor liquidity and volume changes for a token pair over time
* Track price change metrics across multiple timeframes like 1h and 24h
* Retrieve both base and quote token metadata in the same response
* Convert pricing and market metrics into other fiat currencies when needed

If you want to list all markets where a token trades, use: [**Get Token Markets**](https://docs.mobula.io/rest-api-reference/endpoint/token-markets)

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

***

## Walkthrough to Get Market Details

### 1. Prepare your query

The `market/details` endpoint requires two parameters:

| Parameter    | Description                                                    |
| ------------ | -------------------------------------------------------------- |
| `blockchain` | Blockchain identifier (example: `evm:1`, `solana`, `ethereum`) |
| `address`    | Direct pool or token address                                   |

Optional parameters you can use:

* `currencies`: Comma-separated fiat currencies for conversion (example: `EUR,USD`). Default is USD.

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 pool address to test

To retrieve real market data:

* Open DexScreener
* Pick a token
* Open one of its trading pools
* Copy the pool contract address

This address is used as the `address` parameter.

### 3. Fill the API form

Once your pool address is ready:

* Enter the blockchain value into `blockchain`
* Paste the pool contract into `address`
* (Optional) add `currencies` if you want multi-currency output
* Click **Send** to retrieve market details

***

## Reviewing the response

The response returns detailed market metrics for the queried pool.

Key fields include:

* `data.base` / `data.quote`: Base and quote token objects including address, symbol, name, decimals, and pricing fields
* `liquidityUSD`: Liquidity available in the market in USD
* `latestTradeDate`: Timestamp of the most recent trade for the market
* `address`: The pool or market address queried
* `exchange`: Exchange metadata including name and logo when available
* `priceUSD` / `priceToken`: Market price fields for the pair
* `priceChange*`: Price change percentages across timeframes like 1h, 4h, 12h, and 24h
* `volume*`: Volume metrics across multiple windows like 1h, 4h, 12h, and 24h
* `trades*` / `buys*` / `sells*`: Trade counts split by timeframe and direction
* `buyers*` / `sellers*` / `traders*`: Unique participant counts across time windows
* `feesPaid*` and `totalFeesPaidUSD`: Aggregated fee metrics when available
* `socials`: Social links when available
* `security`: Basic security-related fields when available

Multi-currency note:\
If you set `currencies=EUR,USD`, the response adds corresponding fields like `priceEUR`, `liquidityEUR`, and other converted values for USD-based metrics.

***

## Try It Live with Mobula Market Details Demo (UI)

You can also test this endpoint using our demo UI:

[Demo UI Homepage](https://mobula-demo-endpoint-production.up.railway.app/)

[Market Details Demo UI](https://mobula-demo-endpoint-production.up.railway.app/market-details)

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

***

## Summary

The [**Get Market Details**](https://docs.mobula.io/rest-api-reference/endpoint/market-details) endpoint helps you:

* Retrieve market details for a pool or token address using blockchain and address
* Get liquidity, volume, price changes, and trading activity across multiple timeframes
* Add multi-currency output using `currencies` when needed
* 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/)