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
Copy
Ask AI
curl -X GET "https://api.mobula.io/api/2/market/details?blockchain=solana&address=Bzc9NZfMqkXR6fz1DBph7BDf9BroyEf6pnzESP7v5iiw"
Response Format
For pool queries (when providing anaddress):
Copy
Ask AI
{
"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
Copy
Ask AI
[
{
"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 nameaddress(optional) — Direct pool or token address
asset, symbol, or address.
Usage Examples
Copy
Ask AI
# 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
Copy
Ask AI
[
{
"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"
},
...
}
]
Use Cases
- GET: Single token monitoring, real-time price checks
- POST: Portfolio analysis, bulk market research, dashboard data