Skip to main content

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.

The Get 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, Ethereum, BNB Chain, Base, and more.

​
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 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 If you want trade-level activity instead, use: Get Token Trades

​
Walkthrough to Get Market Details

​
1. Prepare your query

The market/details endpoint requires two parameters:
ParameterDescription
blockchainBlockchain identifier (example: evm:1, solana, ethereum)
addressDirect 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 or 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 Market Details Demo UI Docs

​
Summary

The Get 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