Skip to main content
GET
/
1
/
market
/
pairs
Get market pairs
curl --request GET \
  --url https://demo-api.mobula.io/api/1/market/pairs
{
  "data": {
    "pairs": [
      {
        "token0": {
          "address": "<string>",
          "chainId": "<string>",
          "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>",
          "tokenType": "2020",
          "is_mayhem_mode": null,
          "is_cashback_coin": null,
          "is_agent_mode": null,
          "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": "<string>",
          "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>",
          "tokenType": "2020",
          "is_mayhem_mode": null,
          "is_cashback_coin": null,
          "is_agent_mode": null,
          "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>",
          "burnRate": "<string>",
          "liquidityBurnPercentage": 123,
          "isHoneypot": true,
          "isNotOpenSource": true,
          "renounced": true,
          "locked": "<string>",
          "isWhitelisted": true,
          "isMintable": true,
          "modifyableTax": true,
          "selfDestruct": true
        },
        "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,
        "totalFeesPaidNativeRaw": 0,
        "extraData": {},
        "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,
        "volume_buy_1min": 0,
        "volume_buy_5min": 0,
        "volume_buy_15min": 0,
        "volume_buy_1h": 0,
        "volume_buy_4h": 0,
        "volume_buy_6h": 0,
        "volume_buy_12h": 0,
        "volume_buy_24h": 0,
        "volume_sell_1min": 0,
        "volume_sell_5min": 0,
        "volume_sell_15min": 0,
        "volume_sell_1h": 0,
        "volume_sell_4h": 0,
        "volume_sell_6h": 0,
        "volume_sell_12h": 0,
        "volume_sell_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
      }
    ],
    "total_count": 123
  }
}
Deprecated EndpointThis endpoint is deprecated. Please use the new v2 endpoint instead:
  • /api/2/token/markets — Retrieve all markets/pairs for a token with detailed trading activity, volume, and holdings data

​
Query Details

Provide the token name or contract address as the asset parameter.
When using a contract address, include the blockchain parameter as well. The asset query pattern is explained in detail here.
ParameterTypeDescription
limitstringNumber of results to return (pagination limit).
offsetstringPagination offset to skip results.
idnumberThe Asset Unique Identifier to query.
assetstringThe asset identifier to query. This can be the token’s name or the contract address.
symbolstringToken ticker symbol
blockchainstringBlockchain name or ID, formatted as “evm:1” for Ethereum mainnet or “evm:56” for Binance Smart Chain.
tokensstringComma-separated list of token addresses or names to filter pools containing any of these tokens.
blockchainsstringComma-separated list of blockchain names or IDs to filter pools across multiple networks.
excludeBondedbooleanIf true, excludes bonded liquidity pools (e.g., pools with bonded tokens).
poolTypestringFilter pools by type, such as "uniswap-v2", "uniswap-v3", etc.

​
Usage Examples

  • Query by Token Address, Pool Type, Blockchain
curl -X GET https://api.mobula.io/api/1/market/pairs?limit=25&offset=0&asset=0x6982508145454ce325ddbe47a25d4ec3d2311933&blockchains=ethereum&poolType=uniswap-v3

​
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

​
limit
number | null

Maximum number of results (max: 25)

Required range: x <= 25
​
offset
string
required

Offset for pagination

​
id
number | null

Asset ID

​
asset
string

Token contract address or name

​
symbol
string

Token symbol

​
blockchains
string

Comma-separated blockchain IDs

​
excludeBonded
boolean | null

Exclude bonded pairs

​
poolType
string

Filter by pool type

Response

200 - application/json

Market pairs response

​
data
object
required