Query Details
You can provide the following optional parameters to enhance the response:-
asset
— The identifier of the asset to query, which can be either the token’s name or its contract address. The response includes priceToken and price fields at the top level, representing the asset’s price and its value relative to the paired token, respectively. (Same query pattern asmarket/data
). -
stats
(boolean
) — When set totrue
, returns detailed trade statistics for the given pair, including volume, fees, and number of trades. -
force
(boolean
) — When set totrue
, bypasses cache and returns real-time data for the specified pair.
Usage Examples
- Query by Pair Address and Blockchain
- Query by Base Token (At least one of address, asset or symbol is required)
Query Response
Returns comprehensive data for a given token pair, including:- Token metadata for both base and quote tokens (address, symbol, name, supply, market cap, logo, etc.)
- Liquidity and reserves in USD and token amounts.
- Volume and price changes across multiple timeframes (1m, 5m, 15m, 1h, 4h, 6h, 12h, 24h).
-
All-time statistics for both tokens:
- All-time high (ATH) price and date
- All-time low (ATL) price and date
- Trading activity metrics such as number of trades, buyers, sellers, and fees paid.
- Holdings breakdown (top 10 wallets, dev, insiders, bundlers, snipers).
- Sorting: Results sorted by volume, then liquidity.
-
Pagination: 25 pairs per page; use
offset
for additional results. - Price Source: Prices computed by Mobula’s Octopus engine (learn more).
Query Parameters
Response
200 - application/json
Market pair response
The response is of type object
.