GET
/
1
/
market
/
pair
Get market pair
curl --request GET \
  --url https://explorer-api.mobula.io/api/1/market/pair
{
  "data": {
    "token0": {
      "address": "<string>",
      "price": 123,
      "priceToken": 123,
      "priceTokenString": "<string>",
      "approximateReserveUSD": 123,
      "approximateReserveTokenRaw": "<string>",
      "approximateReserveToken": 123,
      "symbol": "<string>",
      "name": "<string>",
      "id": 123,
      "decimals": 123,
      "totalSupply": 123,
      "circulatingSupply": 123,
      "logo": "<string>",
      "chainId": "<string>",
      "marketCap": 123,
      "marketCapDiluted": 123
    },
    "token1": {
      "address": "<string>",
      "price": 123,
      "priceToken": 123,
      "priceTokenString": "<string>",
      "approximateReserveUSD": 123,
      "approximateReserveTokenRaw": "<string>",
      "approximateReserveToken": 123,
      "symbol": "<string>",
      "name": "<string>",
      "id": 123,
      "decimals": 123,
      "totalSupply": 123,
      "circulatingSupply": 123,
      "logo": "<string>",
      "chainId": "<string>",
      "marketCap": 123,
      "marketCapDiluted": 123
    },
    "volume24h": 123,
    "liquidity": 123,
    "blockchain": "<string>",
    "address": "<string>",
    "createdAt": "<string>",
    "type": "<string>",
    "baseToken": "<string>",
    "exchange": {
      "name": "<string>",
      "logo": "<string>"
    },
    "factory": "<string>",
    "quoteToken": "<string>",
    "price": 123,
    "priceToken": 123,
    "priceTokenString": "<string>",
    "bonded": true,
    "bondingPercentage": 123,
    "bondingCurveAddress": "<string>",
    "trades_1min": 123,
    "buys_1min": 123,
    "sells_1min": 123,
    "volume_1min": 123,
    "buy_volume_1min": 123,
    "sell_volume_1min": 123,
    "sellers_1min": 123,
    "buyers_1min": 123,
    "traders_1min": 123,
    "trades_5min": 123,
    "buys_5min": 123,
    "sells_5min": 123,
    "volume_5min": 123,
    "buy_volume_5min": 123,
    "sell_volume_5min": 123,
    "sellers_5min": 123,
    "buyers_5min": 123,
    "traders_5min": 123,
    "trades_15min": 123,
    "buys_15min": 123,
    "sells_15min": 123,
    "volume_15min": 123,
    "buy_volume_15min": 123,
    "sell_volume_15min": 123,
    "sellers_15min": 123,
    "buyers_15min": 123,
    "traders_15min": 123,
    "trades_1h": 123,
    "buys_1h": 123,
    "sells_1h": 123,
    "volume_1h": 123,
    "buy_volume_1h": 123,
    "sell_volume_1h": 123,
    "sellers_1h": 123,
    "buyers_1h": 123,
    "traders_1h": 123,
    "trades_4h": 123,
    "buys_4h": 123,
    "sells_4h": 123,
    "volume_4h": 123,
    "buy_volume_4h": 123,
    "sell_volume_4h": 123,
    "sellers_4h": 123,
    "buyers_4h": 123,
    "traders_4h": 123,
    "trades_6h": 123,
    "buys_6h": 123,
    "sells_6h": 123,
    "volume_6h": 123,
    "buy_volume_6h": 123,
    "sell_volume_6h": 123,
    "sellers_6h": 123,
    "trades_12h": 123,
    "buys_12h": 123,
    "sells_12h": 123,
    "volume_12h": 123,
    "buy_volume_12h": 123,
    "sell_volume_12h": 123,
    "sellers_12h": 123,
    "buyers_12h": 123,
    "traders_12h": 123,
    "trades_24h": 123,
    "buys_24h": 123,
    "sells_24h": 123,
    "volume_24h": 123,
    "buy_volume_24h": 123,
    "sell_volume_24h": 123,
    "sellers_24h": 123,
    "buyers_24h": 123,
    "traders_24h": 123,
    "pool_addr": 123,
    "price_change_1min": 123,
    "price_change_5min": 123,
    "price_change_1h": 123,
    "price_change_4h": 123,
    "price_change_6h": 123,
    "price_change_12h": 123,
    "price_change_24h": 123,
    "totalFeesPaidUSD": 123,
    "top10Holdings": 123,
    "devHoldings": 123,
    "insidersHoldings": 123,
    "bundlersHoldings": 123,
    "snipersHoldings": 123
  }
}

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 as market/data).
  • stats (boolean) — When set to true, returns detailed trade statistics for the given pair, including volume, fees, and number of trades.
  • force (boolean) — When set to true, bypasses cache and returns real-time data for the specified pair.

Usage Examples

  • Query by Pair Address and Blockchain
curl -X GET https://api.mobula.io/api/1/market/pair?blockchain=ethereum&address=0xa43fe16908251ee70ef74718545e4fe6c5ccec9f
  • Query by Base Token (At least one of address, asset or symbol is required)
curl -X GET https://api.mobula.io/api/1/market/pair?baseToken=0x6982508145454ce325ddbe47a25d4ec3d2311933&symbol=CULT&blockchain=ethereum

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

blockchain
string
asset
string
symbol
string
address
string
baseToken
string
stats
default:false
force
boolean | null
default:false

Response

200 - application/json

Market pair response

The response is of type object.