Skip to main content
GET
/
1
/
market
/
pair
Get market pair
curl --request GET \
  --url https://demo-api.mobula.io/api/1/market/pair
{
  "data": {
    "token0": {
      "address": "<string>",
      "chainId": "<unknown>",
      "symbol": "<string>",
      "name": "<string>",
      "priceTokenString": "<string>",
      "approximateReserveTokenRaw": "<string>",
      "logo": "<string>",
      "bonded_at": "<string>",
      "decimals": 0,
      "id": null,
      "price": 0,
      "priceToken": 0,
      "approximateReserveUSD": 0,
      "approximateReserveToken": 0,
      "totalSupply": 0,
      "circulatingSupply": 0,
      "marketCap": 0,
      "marketCapDiluted": 0,
      "exchange": {
        "name": "<string>",
        "logo": "<string>"
      },
      "factory": "<string>",
      "source": "<string>",
      "sourceFactory": "<string>",
      "liquidity": 123,
      "liquidityMax": 123,
      "bonded": true,
      "bondingPercentage": 123,
      "bondingCurveAddress": "<string>",
      "preBondingFactory": "<string>",
      "poolAddress": "<string>",
      "blockchain": "<string>",
      "type": "<string>",
      "deployer": "<string>",
      "createdAt": "<string>",
      "ath": 123,
      "atl": 123,
      "athDate": "<string>",
      "atlDate": "<string>",
      "holdersCount": 123,
      "top10HoldingsPercentage": 123,
      "top50HoldingsPercentage": 123,
      "top100HoldingsPercentage": 123,
      "top200HoldingsPercentage": 123,
      "devHoldingsPercentage": 123,
      "insidersHoldingsPercentage": 123,
      "bundlersHoldingsPercentage": 123,
      "snipersHoldingsPercentage": 123,
      "proTradersHoldingsPercentage": 123,
      "freshTradersHoldingsPercentage": 123,
      "smartTradersHoldingsPercentage": 123,
      "insidersCount": 123,
      "bundlersCount": 123,
      "snipersCount": 123,
      "freshTradersCount": 123,
      "proTradersCount": 123,
      "smartTradersCount": 123,
      "freshTradersBuys": 123,
      "proTradersBuys": 123,
      "smartTradersBuys": 123
    },
    "token1": {
      "address": "<string>",
      "chainId": "<unknown>",
      "symbol": "<string>",
      "name": "<string>",
      "priceTokenString": "<string>",
      "approximateReserveTokenRaw": "<string>",
      "logo": "<string>",
      "bonded_at": "<string>",
      "decimals": 0,
      "id": null,
      "price": 0,
      "priceToken": 0,
      "approximateReserveUSD": 0,
      "approximateReserveToken": 0,
      "totalSupply": 0,
      "circulatingSupply": 0,
      "marketCap": 0,
      "marketCapDiluted": 0,
      "exchange": {
        "name": "<string>",
        "logo": "<string>"
      },
      "factory": "<string>",
      "source": "<string>",
      "sourceFactory": "<string>",
      "liquidity": 123,
      "liquidityMax": 123,
      "bonded": true,
      "bondingPercentage": 123,
      "bondingCurveAddress": "<string>",
      "preBondingFactory": "<string>",
      "poolAddress": "<string>",
      "blockchain": "<string>",
      "type": "<string>",
      "deployer": "<string>",
      "createdAt": "<string>",
      "ath": 123,
      "atl": 123,
      "athDate": "<string>",
      "atlDate": "<string>",
      "holdersCount": 123,
      "top10HoldingsPercentage": 123,
      "top50HoldingsPercentage": 123,
      "top100HoldingsPercentage": 123,
      "top200HoldingsPercentage": 123,
      "devHoldingsPercentage": 123,
      "insidersHoldingsPercentage": 123,
      "bundlersHoldingsPercentage": 123,
      "snipersHoldingsPercentage": 123,
      "proTradersHoldingsPercentage": 123,
      "freshTradersHoldingsPercentage": 123,
      "smartTradersHoldingsPercentage": 123,
      "insidersCount": 123,
      "bundlersCount": 123,
      "snipersCount": 123,
      "freshTradersCount": 123,
      "proTradersCount": 123,
      "smartTradersCount": 123,
      "freshTradersBuys": 123,
      "proTradersBuys": 123,
      "smartTradersBuys": 123
    },
    "blockchain": "<string>",
    "address": "<string>",
    "createdAt": "<string>",
    "type": "<string>",
    "baseToken": "<string>",
    "exchange": {
      "name": "<string>",
      "logo": "<string>"
    },
    "factory": "<string>",
    "quoteToken": "<string>",
    "bondingPercentage": 123,
    "bondingCurveAddress": "<string>",
    "created_at": "<string>",
    "source": "<string>",
    "deployer": "<string>",
    "tokenSymbol": "<string>",
    "tokenName": "<string>",
    "socials": {
      "twitter": "<string>",
      "website": "<string>",
      "telegram": "<string>",
      "others": {},
      "uri": "<string>"
    },
    "description": "<string>",
    "security": {
      "buyTax": "<string>",
      "sellTax": "<string>",
      "transferPausable": true,
      "top10Holders": "<string>",
      "isBlacklisted": true,
      "noMintAuthority": true,
      "balanceMutable": true,
      "lowLiquidity": "<string>"
    },
    "holders_list": [
      {
        "address": "<string>",
        "balanceRaw": "<string>",
        "nativeBalanceRaw": "<string>",
        "balance": 123,
        "nativeBalance": 123,
        "balanceUSD": 123,
        "boughtAmountRaw": "<string>",
        "boughtAmount": 123,
        "boughtAmountUSD": 123,
        "soldAmount": 123,
        "soldAmountRaw": "<string>",
        "soldAmountUSD": 123,
        "realizedPnlUSD": 123,
        "unrealizedPnlUSD": 123,
        "tags": [
          "<string>"
        ],
        "createdAt": "<string>",
        "updatedAt": "<string>"
      }
    ],
    "volume24h": 0,
    "liquidity": 0,
    "price": 0,
    "priceToken": 123,
    "priceTokenString": "<string>",
    "athToken0": 0,
    "athToken1": 0,
    "atlToken0": 0,
    "atlToken1": 0,
    "athDateToken0": "<string>",
    "athDateToken1": "<string>",
    "atlDateToken0": "<string>",
    "atlDateToken1": "<string>",
    "bonded": true,
    "sourceFactory": "<string>",
    "totalFeesPaidUSD": 0,
    "price_change_1min": 0,
    "price_change_5min": 0,
    "price_change_1h": 0,
    "price_change_4h": 0,
    "price_change_6h": 0,
    "price_change_12h": 0,
    "price_change_24h": 0,
    "price_1min_ago": 0,
    "price_5min_ago": 0,
    "price_1h_ago": 0,
    "price_4h_ago": 0,
    "price_6h_ago": 0,
    "price_12h_ago": 0,
    "price_24h_ago": 0,
    "volume_1min": 0,
    "volume_5min": 0,
    "volume_15min": 0,
    "volume_1h": 0,
    "volume_4h": 0,
    "volume_6h": 0,
    "volume_12h": 0,
    "volume_24h": 0,
    "trades_1min": 0,
    "trades_5min": 0,
    "trades_15min": 0,
    "trades_1h": 0,
    "trades_4h": 0,
    "trades_6h": 0,
    "trades_12h": 0,
    "trades_24h": 0,
    "buys_1min": 0,
    "buys_5min": 0,
    "buys_15min": 0,
    "buys_1h": 0,
    "buys_4h": 0,
    "buys_6h": 0,
    "buys_12h": 0,
    "buys_24h": 0,
    "sells_1min": 0,
    "sells_5min": 0,
    "sells_15min": 0,
    "sells_1h": 0,
    "sells_4h": 0,
    "sells_6h": 0,
    "sells_12h": 0,
    "sells_24h": 0,
    "buyers_1min": 0,
    "buyers_5min": 0,
    "buyers_15min": 0,
    "buyers_1h": 0,
    "buyers_4h": 0,
    "buyers_6h": 0,
    "buyers_12h": 0,
    "buyers_24h": 0,
    "sellers_1min": 0,
    "sellers_5min": 0,
    "sellers_15min": 0,
    "sellers_1h": 0,
    "sellers_4h": 0,
    "sellers_6h": 0,
    "sellers_12h": 0,
    "sellers_24h": 0,
    "traders_1min": 0,
    "traders_5min": 0,
    "traders_15min": 0,
    "traders_1h": 0,
    "traders_4h": 0,
    "traders_6h": 0,
    "traders_12h": 0,
    "traders_24h": 0,
    "fees_paid_1min": 0,
    "fees_paid_5min": 0,
    "fees_paid_15min": 0,
    "fees_paid_1h": 0,
    "fees_paid_4h": 0,
    "fees_paid_6h": 0,
    "fees_paid_12h": 0,
    "fees_paid_24h": 0,
    "market_cap": 0,
    "holders_count": 0,
    "latest_trade_date": null,
    "latest_price": 0,
    "dexscreenerListed": true,
    "deployerMigrations": 0,
    "twitterReusesCount": 0,
    "twitterRenameCount": 0,
    "twitterRenameHistory": [
      {
        "username": "<string>",
        "last_checked": "<string>"
      }
    ],
    "holdersCount": 123,
    "top10HoldingsPercentage": 123,
    "top50HoldingsPercentage": 123,
    "top100HoldingsPercentage": 123,
    "top200HoldingsPercentage": 123,
    "devHoldingsPercentage": 123,
    "insidersHoldingsPercentage": 123,
    "bundlersHoldingsPercentage": 123,
    "snipersHoldingsPercentage": 123,
    "proTradersHoldingsPercentage": 123,
    "freshTradersHoldingsPercentage": 123,
    "smartTradersHoldingsPercentage": 123,
    "insidersCount": 123,
    "bundlersCount": 123,
    "snipersCount": 123,
    "freshTradersCount": 123,
    "proTradersCount": 123,
    "smartTradersCount": 123,
    "freshTradersBuys": 123,
    "proTradersBuys": 123,
    "smartTradersBuys": 123,
    "buy_volume_1min": 123,
    "sell_volume_1min": 123,
    "buy_volume_5min": 123,
    "sell_volume_5min": 123,
    "buy_volume_15min": 123,
    "sell_volume_15min": 123,
    "buy_volume_1h": 123,
    "sell_volume_1h": 123,
    "buy_volume_4h": 123,
    "sell_volume_4h": 123,
    "buy_volume_6h": 123,
    "sell_volume_6h": 123,
    "buy_volume_12h": 123,
    "sell_volume_12h": 123,
    "buy_volume_24h": 123,
    "sell_volume_24h": 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:
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

​
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

​
data
object
required