Skip to main content
GET
Get market details for a single token or pair
Batch Support Available: This endpoint supports batch queries via POST method for fetching multiple markets in a single request. Jump to Batch Query section

Overview

The Market Details endpoint provides comprehensive market data for tokens and pairs. It supports both single-item queries (GET) and batch queries (POST) for efficient data retrieval.

GET Method - Single Item Query

Retrieve detailed market information for a single token pair or token.

Query Parameters

  • blockchain (required) — The blockchain identifier (e.g., evm:1, solana, ethereum)
  • address (required) — Direct pool or token address
  • currencies (optional) — Comma-separated list of fiat currencies for price conversion. Defaults to USD. Supported currencies: USD, EUR, GBP, JPY, CHF, CAD, AUD, CNY, KRW, INR, BRL

Step-by-Step Tutorial and Video Walkthrough

  • Check out the guide: Here

Usage Examples

Response Format

For pool queries (when providing an address):

Multi-Currency Support

When you specify multiple currencies using the currencies parameter, the response will include additional fields for each currency. For every field ending in USD, a corresponding field will be added for each requested currency.

Example with currencies=EUR,USD

Converted Fields

The following field patterns are automatically converted (including nested base and quote tokens):
  • priceUSDprice{CURRENCY}
  • liquidityUSDliquidity{CURRENCY}
  • marketCapUSD, marketCapDilutedUSDmarketCap{CURRENCY}, marketCapDiluted{CURRENCY}
  • volume*USD (all timeframes) → volume*{CURRENCY}
  • volumeBuy*USD, volumeSell*USDvolumeBuy*{CURRENCY}, volumeSell*{CURRENCY}
  • approximateReserveUSDapproximateReserve{CURRENCY}
  • athUSD, atlUSDath{CURRENCY}, atl{CURRENCY}
  • feesPaid*USD, totalFeesPaidUSDfeesPaid*{CURRENCY}, totalFeesPaid{CURRENCY}
Exchange rates are fetched from reliable forex data providers and cached for optimal performance. Rates are updated every 30 minutes.

POST Method - Batch Query

Retrieve market details for multiple tokens or pairs in a single request for improved efficiency.

Request Body

Body Parameters

The request body is an array of query objects, where each object contains:
  • blockchain (required) — Blockchain id or name (string, e.g., "evm:1", "solana:solana")
  • address (required) — Direct pool or token address
  • currencies (optional) — Comma-separated list of fiat currencies for price conversion. Defaults to USD

Usage Examples

Response Format

🔗 View Complete Schemas: OpenAPI Specification → Components → Schemas

Liquidity Burn

PumpFun Flags

The base and quote token objects include PumpFun-specific flags for tokens launched on PumpFun (Solana). These are null for non-PumpFun tokens.

OG Coin

Each token object also carries the OG-coin flag (chain-scoped name uniqueness).

Use Cases

  • GET: Single token monitoring, real-time price checks
  • POST: Portfolio analysis, bulk market research, dashboard data

Query Parameters

chainId
string

Blockchain chain ID (e.g., "evm:56", "solana:solana")

address
string

Pool/pair contract address

baseToken
string

Base token address

currencies
string

Comma-separated currencies for price conversion

Response

200 - application/json

Market details response

data
object
required
hostname
string