Query Details
Provide the token name or contract address as theasset
parameter.When using a contract address, include the
blockchain
parameter as well.
The asset query pattern is explained in detail here.
Parameter | Type | Description | |
---|---|---|---|
limit | string | Number of results to return (pagination limit). | |
offset | string | Pagination offset to skip results. | |
id | number | The Asset Unique Identifier to query. | |
asset | string | The asset identifier to query. This can be the token’s name or the contract address. | |
symbol | string | Token ticker symbol | |
blockchain | string | Blockchain name or ID, formatted as “evm:1” for Ethereum mainnet or “evm:56” for Binance Smart Chain. | |
tokens | string | Comma-separated list of token addresses or names to filter pools containing any of these tokens. | |
blockchains | string | Comma-separated list of blockchain names or IDs to filter pools across multiple networks. | |
excludeBonded | boolean | If true , excludes bonded liquidity pools (e.g., pools with bonded tokens). | |
poolType | string | Filter pools by type, such as "uniswap-v2" , "uniswap-v3" , etc. |
Usage Examples
- Query by Token Address, Pool Type, Blockchain
Query Response
Returns comprehensive data for a given token pair, including:Note: The
type
field indicates the protocol fork (e.g., uniswap-v2) rather than the exact pool, aiding integration and standardization across forks. - 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
Required range:
x <= 25
Response
200 - application/json
Market pairs response