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": "<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,
        "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
  }
}

​
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
default:25
Required range: x <= 25
​
offset
string
default:0
​
id
number | null
​
asset
string
​
symbol
string
​
blockchain
string
​
tokens
string
​
blockchains
string
​
excludeBonded
boolean | null
default:false
​
poolType
string

Response

200 - application/json

Market pairs response

​
data
object
required