Skip to main content
GET
/
2
/
market
/
details
Get market details for a single token or pair
curl --request GET \
  --url https://explorer-api.mobula.io/api/2/market/details
{
  "data": {
    "token0": {
      "address": "<string>",
      "chainId": "<any>",
      "symbol": "<string>",
      "name": "<string>",
      "decimals": 0,
      "id": null,
      "priceUSD": 0,
      "priceToken": 0,
      "priceTokenString": "<string>",
      "approximateReserveUSD": 0,
      "approximateReserveTokenRaw": "<string>",
      "approximateReserveToken": 0,
      "totalSupply": 0,
      "circulatingSupply": 0,
      "marketCapUSD": 0,
      "marketCapDilutedUSD": 0,
      "logo": "<string>",
      "exchange": {
        "name": "<string>",
        "logo": "<string>"
      },
      "factory": "<string>",
      "source": "<string>",
      "sourceFactory": "<string>",
      "liquidityUSD": 123,
      "liquidityMaxUSD": 123,
      "bonded": true,
      "bondingPercentage": 123,
      "bondingCurveAddress": "<string>",
      "preBondingFactory": "<string>",
      "poolAddress": "<string>",
      "blockchain": "<string>",
      "type": "<string>",
      "deployer": "<string>",
      "createdAt": "<string>",
      "bondedAt": "<string>",
      "athUSD": 123,
      "atlUSD": 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": "<any>",
      "symbol": "<string>",
      "name": "<string>",
      "decimals": 0,
      "id": null,
      "priceUSD": 0,
      "priceToken": 0,
      "priceTokenString": "<string>",
      "approximateReserveUSD": 0,
      "approximateReserveTokenRaw": "<string>",
      "approximateReserveToken": 0,
      "totalSupply": 0,
      "circulatingSupply": 0,
      "marketCapUSD": 0,
      "marketCapDilutedUSD": 0,
      "logo": "<string>",
      "exchange": {
        "name": "<string>",
        "logo": "<string>"
      },
      "factory": "<string>",
      "source": "<string>",
      "sourceFactory": "<string>",
      "liquidityUSD": 123,
      "liquidityMaxUSD": 123,
      "bonded": true,
      "bondingPercentage": 123,
      "bondingCurveAddress": "<string>",
      "preBondingFactory": "<string>",
      "poolAddress": "<string>",
      "blockchain": "<string>",
      "type": "<string>",
      "deployer": "<string>",
      "createdAt": "<string>",
      "bondedAt": "<string>",
      "athUSD": 123,
      "atlUSD": 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
    },
    "base": {
      "address": "<string>",
      "chainId": "<any>",
      "symbol": "<string>",
      "name": "<string>",
      "decimals": 0,
      "id": null,
      "priceUSD": 0,
      "priceToken": 0,
      "priceTokenString": "<string>",
      "approximateReserveUSD": 0,
      "approximateReserveTokenRaw": "<string>",
      "approximateReserveToken": 0,
      "totalSupply": 0,
      "circulatingSupply": 0,
      "marketCapUSD": 0,
      "marketCapDilutedUSD": 0,
      "logo": "<string>",
      "exchange": {
        "name": "<string>",
        "logo": "<string>"
      },
      "factory": "<string>",
      "source": "<string>",
      "sourceFactory": "<string>",
      "liquidityUSD": 123,
      "liquidityMaxUSD": 123,
      "bonded": true,
      "bondingPercentage": 123,
      "bondingCurveAddress": "<string>",
      "preBondingFactory": "<string>",
      "poolAddress": "<string>",
      "blockchain": "<string>",
      "type": "<string>",
      "deployer": "<string>",
      "createdAt": "<string>",
      "bondedAt": "<string>",
      "athUSD": 123,
      "atlUSD": 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
    },
    "quote": {
      "address": "<string>",
      "chainId": "<any>",
      "symbol": "<string>",
      "name": "<string>",
      "decimals": 0,
      "id": null,
      "priceUSD": 0,
      "priceToken": 0,
      "priceTokenString": "<string>",
      "approximateReserveUSD": 0,
      "approximateReserveTokenRaw": "<string>",
      "approximateReserveToken": 0,
      "totalSupply": 0,
      "circulatingSupply": 0,
      "marketCapUSD": 0,
      "marketCapDilutedUSD": 0,
      "logo": "<string>",
      "exchange": {
        "name": "<string>",
        "logo": "<string>"
      },
      "factory": "<string>",
      "source": "<string>",
      "sourceFactory": "<string>",
      "liquidityUSD": 123,
      "liquidityMaxUSD": 123,
      "bonded": true,
      "bondingPercentage": 123,
      "bondingCurveAddress": "<string>",
      "preBondingFactory": "<string>",
      "poolAddress": "<string>",
      "blockchain": "<string>",
      "type": "<string>",
      "deployer": "<string>",
      "createdAt": "<string>",
      "bondedAt": "<string>",
      "athUSD": 123,
      "atlUSD": 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
    },
    "liquidityUSD": 0,
    "latestTradeDate": "<string>",
    "blockchain": "<string>",
    "address": "<string>",
    "createdAt": "<string>",
    "type": "<string>",
    "exchange": {
      "name": "<string>",
      "logo": "<string>"
    },
    "factory": "<string>",
    "priceUSD": 123,
    "priceToken": 123,
    "priceTokenString": "<string>",
    "baseToken": "<string>",
    "quoteToken": "<string>",
    "bonded": true,
    "bondingPercentage": 123,
    "preBondingPoolAddress": "<string>",
    "sourceFactory": "<string>",
    "totalFeesPaidUSD": 123,
    "priceChange1minPercentage": 0,
    "priceChange5minPercentage": 0,
    "priceChange1hPercentage": 0,
    "priceChange4hPercentage": 0,
    "priceChange6hPercentage": 0,
    "priceChange12hPercentage": 0,
    "priceChange24hPercentage": 0,
    "volume1minUSD": 0,
    "volume5minUSD": 0,
    "volume15minUSD": 0,
    "volume1hUSD": 0,
    "volume4hUSD": 0,
    "volume6hUSD": 0,
    "volume12hUSD": 0,
    "volume24hUSD": 0,
    "volumeBuy1minUSD": 0,
    "volumeBuy5minUSD": 0,
    "volumeBuy15minUSD": 0,
    "volumeBuy1hUSD": 0,
    "volumeBuy4hUSD": 0,
    "volumeBuy6hUSD": 0,
    "volumeBuy12hUSD": 0,
    "volumeBuy24hUSD": 0,
    "volumeSell1minUSD": 0,
    "volumeSell5minUSD": 0,
    "volumeSell15minUSD": 0,
    "volumeSell1hUSD": 0,
    "volumeSell4hUSD": 0,
    "volumeSell6hUSD": 0,
    "volumeSell12hUSD": 0,
    "volumeSell24hUSD": 0,
    "trades1min": 0,
    "trades5min": 0,
    "trades15min": 0,
    "trades1h": 0,
    "trades4h": 0,
    "trades6h": 0,
    "trades12h": 0,
    "trades24h": 0,
    "buys1min": 0,
    "buys5min": 0,
    "buys15min": 0,
    "buys1h": 0,
    "buys4h": 0,
    "buys6h": 0,
    "buys12h": 0,
    "buys24h": 0,
    "sells1min": 0,
    "sells5min": 0,
    "sells15min": 0,
    "sells1h": 0,
    "sells4h": 0,
    "sells6h": 0,
    "sells12h": 0,
    "sells24h": 0,
    "buyers1min": 0,
    "buyers5min": 0,
    "buyers15min": 0,
    "buyers1h": 0,
    "buyers4h": 0,
    "buyers6h": 0,
    "buyers12h": 0,
    "buyers24h": 0,
    "sellers1min": 0,
    "sellers5min": 0,
    "sellers15min": 0,
    "sellers1h": 0,
    "sellers4h": 0,
    "sellers6h": 0,
    "sellers12h": 0,
    "sellers24h": 0,
    "traders1min": 0,
    "traders5min": 0,
    "traders15min": 0,
    "traders1h": 0,
    "traders4h": 0,
    "traders6h": 0,
    "traders12h": 0,
    "traders24h": 0,
    "feesPaid1minUSD": 0,
    "feesPaid5minUSD": 0,
    "feesPaid15minUSD": 0,
    "feesPaid1hUSD": 0,
    "feesPaid4hUSD": 0,
    "feesPaid6hUSD": 0,
    "feesPaid12hUSD": 0,
    "feesPaid24hUSD": 0,
    "holdersCount": 123,
    "source": "<string>",
    "deployer": "<string>",
    "tokenSymbol": "<string>",
    "tokenName": "<string>",
    "dexscreenerListed": true,
    "deployerMigrations": 0,
    "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>"
    },
    "twitterReusesCount": 0,
    "twitterRenameCount": 0,
    "twitterRenameHistory": [],
    "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
  },
  "hostname": "<string>"
}

Overview

The Market Details endpoint provides comprehensive market data for tokens and pairs. It supports both single-item queries (GET) and batch queries (POST) for efficient data retrieval.

GET Method - Single Item Query

Retrieve detailed market information for a single token pair or token.

Query Parameters

  • blockchain (required) — The blockchain identifier (e.g., evm:1, solana, ethereum)
  • address (required) — Direct pool or token address

Usage Examples

curl -X GET "https://api.mobula.io/api/2/market/details?blockchain=solana&address=Bzc9NZfMqkXR6fz1DBph7BDf9BroyEf6pnzESP7v5iiw"

Response Format

For pool queries (when providing an address):
{
  "data": {
    "base": {
      "address": "0x59264f02d301281f3393e1385c0aefd446eb0f00",
      "chainId": "evm:56",
      "symbol": "PARTI",
      "name": "Particle Network",
      "decimals": 18,
      "id": 102504307,
      "priceUSD": 0.08413688760417291,
      "priceToken": 0.00007486216155186412,
      "priceTokenString": "0.00007486216155186411970630377954",
      "approximateReserveUSD": 664303.7413514056,
      "approximateReserveTokenRaw": "7895511234937317717180416",
      "approximateReserveToken": 7895511.234937318,
      "totalSupply": 1000000000,
      "circulatingSupply": 233311988,
      "marketCapUSD": 19630144.511062138,
      "marketCapDilutedUSD": 84136887.60417292,
      "logo": "https://metacore.mobula.io/ef9883ea0b533172a4326ac7cf8c9785376fe40a90342453cad8c3f1f70e917d.png",
      "factory": "0x0bfbcf9fa4f9c56b0f40a671ad40e0805a091865",
      "source": "",
      "sourceFactory": "",
      "liquidityUSD": 0,
      "liquidityMaxUSD": 0,
      "bonded": false,
      "bondingPercentage": 0,
      "bondingCurveAddress": "",
      "preBondingFactory": "",
      "blockchain": "BNB Smart Chain (BEP20)",
      "deployer": "0x00f7f27b9fa41aef6a76c5dfc6873993195392f4",
      "createdAt": "2025-03-24T03:26:44.000Z",
      "bondedAt": null,
      "athUSD": 0.20030426368603288,
      "atlUSD": 0.0752956614056526,
      "top10HoldingsPercentage": 0,
      "top50HoldingsPercentage": 0,
      "top100HoldingsPercentage": 0,
      "top200HoldingsPercentage": 0,
      "devHoldingsPercentage": 0,
      "insidersHoldingsPercentage": 0,
      "bundlersHoldingsPercentage": 0,
      "snipersHoldingsPercentage": 0,
      "proTradersHoldingsPercentage": 0,
      "freshTradersHoldingsPercentage": 0,
      "insidersCount": 0,
      "bundlersCount": 0,
      "snipersCount": 0,
      "freshTradersCount": 0,
      "proTradersCount": 0
    },
    "quote": {
      "address": "0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c",
      "chainId": "evm:56",
      "symbol": "BNB",
      "name": "BNB",
      "decimals": 18,
      "id": 100001566,
      "priceUSD": 1121.552123172978,
      "priceToken": 13357.88306496073,
      "priceTokenString": "13357.88306496072982554323971271514893",
      "approximateReserveUSD": 192450.58624645785,
      "approximateReserveTokenRaw": "171593082720040484864",
      "approximateReserveToken": 171.59308272004048,
      "totalSupply": 146597006,
      "circulatingSupply": 139210333,
      "marketCapUSD": 156131644543.7673,
      "marketCapDilutedUSD": 164416183330.1018,
      "logo": "https://coin-images.coingecko.com/coins/images/825/large/bnb-icon2_2x.png?1696501970",
      "factory": "0x0bfbcf9fa4f9c56b0f40a671ad40e0805a091865",
      "source": "",
      "sourceFactory": "",
      "liquidityUSD": 0,
      "liquidityMaxUSD": 0,
      "bonded": false,
      "bondingPercentage": 0,
      "bondingCurveAddress": "",
      "preBondingFactory": "",
      "blockchain": "BNB Smart Chain (BEP20)",
      "deployer": "0x42f7d330a13b3a3b5f079d16f390df73e0fe31f6",
      "createdAt": "2025-03-24T03:26:44.000Z",
      "bondedAt": null,
      "athUSD": 1366.9743341519356,
      "atlUSD": 861.532016646401,
      "top10HoldingsPercentage": 100,
      "top50HoldingsPercentage": 100,
      "top100HoldingsPercentage": 100,
      "top200HoldingsPercentage": 100,
      "devHoldingsPercentage": 0,
      "insidersHoldingsPercentage": 0,
      "bundlersHoldingsPercentage": 100,
      "snipersHoldingsPercentage": 0,
      "proTradersHoldingsPercentage": 0,
      "freshTradersHoldingsPercentage": 0,
      "insidersCount": 0,
      "bundlersCount": 525,
      "snipersCount": 0,
      "freshTradersCount": 0,
      "proTradersCount": 0
    },
    "liquidityUSD": 856754.3275978635,
    "latestTradeDate": "2025-10-24T07:55:00.000Z",
    "blockchain": "BNB Smart Chain (BEP20)",
    "address": "0xc0fb39f705ee65ef098dd5452997a7846d156aa9",
    "createdAt": "2025-03-24T03:26:44.000Z",
    "type": "uniswap-v3",
    "exchange": {
      "name": "PancakeSwap V3",
      "logo": "https://metadata.mobula.io/assets/logos/0x0bfbcf9fa4f9c56b0f40a671ad40e0805a091865.webp"
    },
    "factory": "0x0bfbcf9fa4f9c56b0f40a671ad40e0805a091865",
    "priceUSD": 0.08413688760417291,
    "priceToken": 0.00007486216155186412,
    "priceTokenString": "0.00007486216155186411970630377954",
    "baseToken": "token0",
    "quoteToken": "token1",
    "bonded": false,
    "bondingPercentage": 0,
    "preBondingPoolAddress": "",
    "sourceFactory": null,
    "totalFeesPaidUSD": 0,
    "priceChange1minPercentage": 0,
    "priceChange5minPercentage": -0.04367428014992045,
    "priceChange1hPercentage": -0.3651755954393361,
    "priceChange4hPercentage": 3.36584497495304,
    "priceChange6hPercentage": 3.666051154864186,
    "priceChange12hPercentage": 4.214797178111493,
    "priceChange24hPercentage": 3.354550118373953,
    "volume1minUSD": 192.2440841998732,
    "volume5minUSD": 388.87588231442544,
    "volume15minUSD": 388.87588231442544,
    "volume1hUSD": 1182.5064543023655,
    "volume4hUSD": 6543.132760076441,
    "volume6hUSD": 6544.056862317916,
    "volume12hUSD": 7699.668602953875,
    "volume24hUSD": 19221.88402828513,
    "volumeBuy1minUSD": 189.9905436988188,
    "volumeBuy5minUSD": 386.622341813371,
    "volumeBuy15minUSD": 386.622341813371,
    "volumeBuy1hUSD": 1180.252913801311,
    "volumeBuy4hUSD": 6533.928640375349,
    "volumeBuy6hUSD": 6533.928640375349,
    "volumeBuy12hUSD": 6536.328531514263,
    "volumeBuy24hUSD": 10821.77282226436,
    "volumeSell1minUSD": 2.253540501054411,
    "volumeSell5minUSD": 2.253540501054411,
    "volumeSell15minUSD": 2.253540501054411,
    "volumeSell1hUSD": 2.253540501054411,
    "volumeSell4hUSD": 9.204119701092013,
    "volumeSell6hUSD": 10.12822194256768,
    "volumeSell12hUSD": 1163.340071439612,
    "volumeSell24hUSD": 8400.111206020769,
    "trades1min": 0,
    "trades5min": 2,
    "trades15min": 2,
    "trades1h": 6,
    "trades4h": 47,
    "trades6h": 48,
    "trades12h": 57,
    "trades24h": 119,
    "buys1min": 0,
    "buys5min": 2,
    "buys15min": 2,
    "buys1h": 6,
    "buys4h": 37,
    "buys6h": 37,
    "buys12h": 38,
    "buys24h": 69,
    "sells1min": 0,
    "sells5min": 0,
    "sells15min": 0,
    "sells1h": 0,
    "sells4h": 10,
    "sells6h": 11,
    "sells12h": 19,
    "sells24h": 50,
    "buyers1min": 0,
    "buyers5min": 2,
    "buyers15min": 2,
    "buyers1h": 5,
    "buyers4h": 32,
    "buyers6h": 32,
    "buyers12h": 33,
    "buyers24h": 61,
    "sellers1min": 0,
    "sellers5min": 0,
    "sellers15min": 0,
    "sellers1h": 0,
    "sellers4h": 10,
    "sellers6h": 11,
    "sellers12h": 18,
    "sellers24h": 46,
    "traders1min": 0,
    "traders5min": 2,
    "traders15min": 2,
    "traders1h": 5,
    "traders4h": 42,
    "traders6h": 43,
    "traders12h": 51,
    "traders24h": 107,
    "feesPaid1minUSD": 0,
    "feesPaid5minUSD": 0,
    "feesPaid15minUSD": 0,
    "feesPaid1hUSD": 0,
    "feesPaid4hUSD": 0,
    "feesPaid6hUSD": 0,
    "feesPaid12hUSD": 0,
    "feesPaid24hUSD": 0,
    "holdersCount": 0,
    "source": null,
    "deployer": "0x00f7f27b9fa41aef6a76c5dfc6873993195392f4",
    "tokenSymbol": "PARTI",
    "tokenName": "PARTI Token",
    "dexscreenerListed": true,
    "deployerMigrations": 0,
    "socials": {
      "twitter": "https://x.com/ParticleNtwrk",
      "website": "https://particle.network/",
      "telegram": null,
      "others": {}
    },
    "description": null,
    "security": {
      "buyTax": "0",
      "sellTax": "0",
      "transferPausable": false,
      "top10Holders": "0.7913",
      "isBlacklisted": false,
      "balanceMutable": false
    },
    "twitterReusesCount": 0,
    "twitterRenameCount": 0,
    "twitterRenameHistory": [],
    "extraData": {
      "sqrtPriceX96": "683342645871778606975567665",
      "sqrtPriceX64": "0",
      "tickSpacing": 200,
      "tick": 0,
      "binId": 0,
      "binStep": 0,
      "isStable": false,
      "amp": "0",
      "token0Type": 0,
      "token1Type": 0,
      "storedRates0": "0",
      "storedRates1": "0",
      "account0": "",
      "account1": "",
      "maxFunds": "",
      "realTokenReserves": "0",
      "initialRealTokenReserves": "0",
      "initialVirtualTokenReserves": "0",
      "decimals0": 0,
      "decimals1": 0,
      "aVaultLp": "",
      "bVaultLp": "",
      "aVaultLpMint": "",
      "bVaultLpMint": "",
      "migrationQuoteThreshold": "0",
      "sqrtPriceStart": "0",
      "curve": "",
      "weights": "",
      "poolId": "",
      "maxBid": "0",
      "minAsk": "0",
      "lastTradedPrice": 0
    },
    "top10HoldingsPercentage": 0,
    "top50HoldingsPercentage": 0,
    "top100HoldingsPercentage": 0,
    "top200HoldingsPercentage": 0,
    "devHoldingsPercentage": 0,
    "insidersHoldingsPercentage": 0,
    "bundlersHoldingsPercentage": 0,
    "snipersHoldingsPercentage": 0,
    "proTradersHoldingsPercentage": 0,
    "freshTradersHoldingsPercentage": 0,
    "insidersCount": 0,
    "bundlersCount": 0,
    "snipersCount": 0,
    "freshTradersCount": 0,
    "proTradersCount": 0
  }
}

POST Method - Batch Query

Retrieve market details for multiple tokens or pairs in a single request for improved efficiency.

Request Body

[
  {
    "blockchain": "evm:1",
    "address": "0x9Ec9367b8c4Dd45ec8E7b800b1F719251053AD60"
  },
  {
    "blockchain": "solana:solana",
    "address": "4Xh3Yv8JiGFPcDHjxcTPNTtAg8sA6HDvd7fyDXakbS75"
  }
]

Body Parameters

The request body is an array of query objects, where each object contains:
  • blockchain (required) — Blockchain id or name
  • address (optional) — Direct pool or token address
Note: Each array item must specify either asset, symbol, or address.

Usage Examples

# Batch query with mixed asset types
curl -X POST "https://api.mobula.io/api/2/market/details" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "blockchain": {"id": "evm:1"},
      "asset": "bitcoin"
    },
    {
      "blockchain": {"id": "evm:1"},
      "address": "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599"
    },
    {
      "blockchain": {"id": "evm:1"},
      "symbol": "ETH"
    }
  ]'

Response Format

[
  {
    "baseToken": {
      "address": "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599",
      "chainId": 1,
      "symbol": "TOKEN0",
      "name": "Token Zero",
      "decimals": 18,
      "id": 12345,
      "priceUSD": 1.2345,
      ...
    },
    "quoteToken": {
      "address": "0x0987654321098765432109876543210987654321",
      "chainId": 1,
      "symbol": "TOKEN1",
      "name": "Token One",
      "decimals": 18,
      "id": 67890,
      "priceUSD": 0.5678,
      ...
    },
    "liquidityUSD": 1804459.12,
    "blockchain": "ethereum",
    "address": "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599",
    "createdAt": "2023-01-15T10:30:00.000Z",
    "type": "uniswap_v2",
    "exchange": {
      "name": "Uniswap",
      "logo": "https://example.com/uniswap-logo.png"
    },
    ...
  },
  {
    "baseToken": {
      "address": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd",
      "chainId": 56,
      "symbol": "CAKE",
      "name": "PancakeSwap",
      "decimals": 18,
      "id": 99999,
      "priceUSD": 2.3456,
      ...
    },
    "quoteToken": {
      "address": "0xbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
      "chainId": 56,
      "symbol": "BNB",
      "name": "Binance Coin",
      "decimals": 18,
      "id": 88888,
      "priceUSD": 245.67,
      ...
    },
    "liquidityUSD": 5678901.23,
    "blockchain": "bsc",
    "address": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd",
    "createdAt": "2023-02-01T12:00:00.000Z",
    "type": "pancakeswap_v2",
    "exchange": {
      "name": "PancakeSwap",
      "logo": "https://example.com/pancakeswap-logo.png"
    },
    ...
  }
]
🔗 View Complete Schemas: OpenAPI Specification → Components → Schemas

Use Cases

  • GET: Single token monitoring, real-time price checks
  • POST: Portfolio analysis, bulk market research, dashboard data

Query Parameters

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

Response

200 - application/json

Market details response

data
object
required
hostname
string