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": {
    "address": "<string>",
    "chainId": "<any>",
    "symbol": "<string>",
    "name": "<string>",
    "decimals": 0,
    "id": null,
    "price": 0,
    "priceToken": 0,
    "priceTokenString": "<string>",
    "approximateReserveUSD": 0,
    "approximateReserveTokenRaw": "<string>",
    "approximateReserveToken": 0,
    "totalSupply": 0,
    "circulatingSupply": 0,
    "marketCap": 0,
    "marketCapDiluted": 0,
    "logo": "<string>",
    "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>",
    "top10HoldingsPercentage": 123,
    "top50HoldingsPercentage": 123,
    "top100HoldingsPercentage": 123,
    "top200HoldingsPercentage": 123,
    "devHoldingsPercentage": 123,
    "insidersHoldingsPercentage": 123,
    "bundlersHoldingsPercentage": 123,
    "snipersHoldingsPercentage": 123,
    "proTradersHoldingsPercentage": 123,
    "blockchain": "<string>",
    "type": "<string>",
    "deployer": "<string>",
    "createdAt": "<string>",
    "bonded_at": "<string>",
    "ath": 123,
    "atl": 123,
    "athDate": "<string>",
    "atlDate": "<string>",
    "latest_trade_date": "<string>",
    "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,
    "totalFeesPaidUSD": 0,
    "organic_trades_1min": 0,
    "organic_trades_5min": 0,
    "organic_trades_15min": 0,
    "organic_trades_1h": 0,
    "organic_trades_4h": 0,
    "organic_trades_6h": 0,
    "organic_trades_12h": 0,
    "organic_trades_24h": 0,
    "organic_traders_1min": 0,
    "organic_traders_5min": 0,
    "organic_traders_15min": 0,
    "organic_traders_1h": 0,
    "organic_traders_4h": 0,
    "organic_traders_6h": 0,
    "organic_traders_12h": 0,
    "organic_traders_24h": 0,
    "organic_volume_1min": 0,
    "organic_volume_5min": 0,
    "organic_volume_15min": 0,
    "organic_volume_1h": 0,
    "organic_volume_4h": 0,
    "organic_volume_6h": 0,
    "organic_volume_12h": 0,
    "organic_volume_24h": 0,
    "organic_volume_buy_1min": 0,
    "organic_volume_buy_5min": 0,
    "organic_volume_buy_15min": 0,
    "organic_volume_buy_1h": 0,
    "organic_volume_buy_4h": 0,
    "organic_volume_buy_6h": 0,
    "organic_volume_buy_12h": 0,
    "organic_volume_buy_24h": 0,
    "organic_volume_sell_1min": 0,
    "organic_volume_sell_5min": 0,
    "organic_volume_sell_15min": 0,
    "organic_volume_sell_1h": 0,
    "organic_volume_sell_4h": 0,
    "organic_volume_sell_6h": 0,
    "organic_volume_sell_12h": 0,
    "organic_volume_sell_24h": 0,
    "organic_buys_1min": 0,
    "organic_buys_5min": 0,
    "organic_buys_15min": 0,
    "organic_buys_1h": 0,
    "organic_buys_4h": 0,
    "organic_buys_6h": 0,
    "organic_buys_12h": 0,
    "organic_buys_24h": 0,
    "organic_sells_1min": 0,
    "organic_sells_5min": 0,
    "organic_sells_15min": 0,
    "organic_sells_1h": 0,
    "organic_sells_4h": 0,
    "organic_sells_6h": 0,
    "organic_sells_12h": 0,
    "organic_sells_24h": 0,
    "organic_buyers_1min": 0,
    "organic_buyers_5min": 0,
    "organic_buyers_15min": 0,
    "organic_buyers_1h": 0,
    "organic_buyers_4h": 0,
    "organic_buyers_6h": 0,
    "organic_buyers_12h": 0,
    "organic_buyers_24h": 0,
    "organic_sellers_1min": 0,
    "organic_sellers_5min": 0,
    "organic_sellers_15min": 0,
    "organic_sellers_1h": 0,
    "organic_sellers_4h": 0,
    "organic_sellers_6h": 0,
    "organic_sellers_12h": 0,
    "organic_sellers_24h": 0,
    "created_at": "<string>",
    "latest_price": 0,
    "holders_count": 0,
    "market_cap": 0,
    "latest_market_cap": 0,
    "description": "<string>",
    "socials": {
      "twitter": "<string>",
      "website": "<string>",
      "telegram": "<string>",
      "others": {},
      "uri": "<string>"
    },
    "security": {
      "buyTax": "<string>",
      "sellTax": "<string>",
      "transferPausable": true,
      "top10Holders": "<string>",
      "isBlacklisted": true,
      "noMintAuthority": true,
      "balanceMutable": true,
      "lowLiquidity": "<string>"
    },
    "twitterReusesCount": 0,
    "twitterRenameCount": 0,
    "twitterRenameHistory": [
      {
        "username": "<string>",
        "last_checked": "<string>"
      }
    ],
    "deployerMigrationsCount": 0,
    "dexscreenerListed": false,
    "dexscreenerHeader": null,
    "dexscreenerAdPaid": false,
    "holders_list": [
      {
        "address": "<string>",
        "balance": 123,
        "nativeBalance": 123,
        "balanceUsd": 123,
        "boughtAmount": 123,
        "soldAmount": 123,
        "pnl": 123
      }
    ]
  }
}

​
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): 
{
  "token0": {
    "address": "0x1234567890123456789012345678901234567890",
    "chainId": 1,
    "symbol": "TOKEN0",
    "name": "Token Zero",
    "decimals": 18,
    "id": 12345,
    "priceUSD": 1.2345,
    "priceToken": 0.00012345,
    "priceTokenString": "0.00012345",
    "approximateReserveUSD": 12345.67,
    "approximateReserveTokenRaw": "123456789012345678901234567890",
    "approximateReserveToken": 123456789012345678901234567890,
    "totalSupply": 1000000000,
    "circulatingSupply": 750000000,
    "marketCapUSD": 1234567890,
    "marketCapDilutedUSD": 2345678901,
    "logo": "https://example.com/logo.png",
    "exchange": {
      "name": "Uniswap",
      "logo": "https://example.com/uniswap-logo.png"
    },
    "factory": "0x5C69bEe701ef814a2B6a3EDD4B1652CB9cc5aA6f",
    "source": "uniswap_v2",
    "sourceFactory": "0x5C69bEe701ef814a2B6a3EDD4B1652CB9cc5aA6f",
    "liquidityUSD": 1234567.89,
    "liquidityMaxUSD": 2345678.90,
    "bonded": true,
    "bondingPercentage": 85.5,
    "bondingCurveAddress": "0x1234567890123456789012345678901234567890",
    "preBondingFactory": "0x1234567890123456789012345678901234567890",
    "poolAddress": "0x1234567890123456789012345678901234567890",
    "blockchain": "ethereum",
    "type": "erc20",
    "deployer": "0x1234567890123456789012345678901234567890",
    "createdAt": "2023-01-15T10:30:00.000Z",
    "bondedAt": "2023-01-16T14:20:00.000Z",
    "athUSD": 2.5,
    "atlUSD": 0.1,
    "athDate": "2023-02-01T00:00:00.000Z",
    "atlDate": "2023-01-15T10:30:00.000Z"
  },
  "token1": {
    "address": "0x0987654321098765432109876543210987654321",
    "chainId": 1,
    "symbol": "TOKEN1",
    "name": "Token One",
    "decimals": 18,
    "id": 67890,
    "priceUSD": 0.5678,
    "priceToken": 1.7654,
    "priceTokenString": "1.7654",
    "approximateReserveUSD": 56789.12,
    "approximateReserveTokenRaw": "987654321098765432109876543210",
    "approximateReserveToken": 987654321098765432109876543210,
    "totalSupply": 500000000,
    "circulatingSupply": 400000000,
    "marketCapUSD": 283945000,
    "marketCapDilutedUSD": 340734000,
    "logo": "https://example.com/logo2.png",
    "exchange": {
      "name": "Uniswap",
      "logo": "https://example.com/uniswap-logo.png"
    },
    "factory": "0x5C69bEe701ef814a2B6a3EDD4B1652CB9cc5aA6f",
    "source": "uniswap_v2",
    "sourceFactory": "0x5C69bEe701ef814a2B6a3EDD4B1652CB9cc5aA6f",
    "liquidityUSD": 567891.23,
    "liquidityMaxUSD": 678912.34,
    "bonded": false,
    "bondingPercentage": 0,
    "bondingCurveAddress": null,
    "preBondingFactory": null,
    "poolAddress": "0x0987654321098765432109876543210987654321",
    "blockchain": "ethereum",
    "type": "erc20",
    "deployer": "0x0987654321098765432109876543210987654321",
    "createdAt": "2023-01-10T08:15:00.000Z",
    "bondedAt": null,
    "athUSD": 1.2,
    "atlUSD": 0.05,
    "athDate": "2023-01-20T00:00:00.000Z",
    "atlDate": "2023-01-10T08:15:00.000Z"
  },
  "liquidityUSD": 1804459.12,
  "blockchain": "ethereum",
  "address": "0x1234567890123456789012345678901234567890",
  "createdAt": "2023-01-15T10:30:00.000Z",
  "type": "uniswap_v2",
  "baseToken": "0x1234567890123456789012345678901234567890",
  "exchange": {
    "name": "Uniswap",
    "logo": "https://example.com/uniswap-logo.png"
  },
  "factory": "0x5C69bEe701ef814a2B6a3EDD4B1652CB9cc5aA6f",
  "quoteToken": "0x0987654321098765432109876543210987654321",
  "priceUSD": 1.2345,
  "priceToken": 0.5678,
  "priceTokenString": "0.5678",
  "bonded": true,
  "bondingPercentage": 85.5,
  "preBondingPoolAddress": "0x1234567890123456789012345678901234567890",
  "sourceFactory": "0x5C69bEe701ef814a2B6a3EDD4B1652CB9cc5aA6f",
  "top10HoldingsPercentage": 15.5,
  "top50HoldingsPercentage": 35.2,
  "top100HoldingsPercentage": 45.8,
  "top200HoldingsPercentage": 52.3,
  "devHoldingsPercentage": 8.7,
  "insidersHoldingsPercentage": 12.1,
  "bundlersHoldingsPercentage": 3.4,
  "snipersHoldingsPercentage": 2.8,
  "proTradersHoldingsPercentage": 18.9,
  "totalFeesPaidUSD": 12345.67,
  "priceChange1minPercentage": 0.5,
  "priceChange5minPercentage": 1.2,
  "priceChange1hPercentage": 2.8,
  "priceChange4hPercentage": -1.5,
  "priceChange6hPercentage": 3.2,
  "priceChange12hPercentage": 5.7,
  "priceChange24hPercentage": 8.9,
  "volume1minUSD": 123.45,
  "volume5minUSD": 567.89,
  "volume15minUSD": 1234.56,
  "volume1hUSD": 3456.78,
  "volume4hUSD": 8901.23,
  "volume6hUSD": 12345.67,
  "volume12hUSD": 23456.78,
  "volume24hUSD": 45678.90,
  "volumeBuy1minUSD": 67.89,
  "volumeBuy5minUSD": 312.34,
  "volumeBuy15minUSD": 678.91,
  "volumeBuy1hUSD": 1890.12,
  "volumeBuy4hUSD": 4567.89,
  "volumeBuy6hUSD": 6789.01,
  "volumeBuy12hUSD": 12345.67,
  "volumeBuy24hUSD": 23456.78,
  "volumeSell1minUSD": 55.56,
  "volumeSell5minUSD": 255.55,
  "volumeSell15minUSD": 555.65,
  "volumeSell1hUSD": 1566.66,
  "volumeSell4hUSD": 4333.34,
  "volumeSell6hUSD": 5556.66,
  "volumeSell12hUSD": 11111.11,
  "volumeSell24hUSD": 22222.12,
  "trades1min": 5,
  "trades5min": 23,
  "trades15min": 67,
  "trades1h": 189,
  "trades4h": 456,
  "trades6h": 678,
  "trades12h": 1234,
  "trades24h": 2345,
  "buys1min": 3,
  "buys5min": 12,
  "buys15min": 34,
  "buys1h": 89,
  "buys4h": 234,
  "buys6h": 345,
  "buys12h": 678,
  "buys24h": 1234,
  "sells1min": 2,
  "sells5min": 11,
  "sells15min": 33,
  "sells1h": 100,
  "sells4h": 222,
  "sells6h": 333,
  "sells12h": 556,
  "sells24h": 1111,
  "buyers1min": 3,
  "buyers5min": 10,
  "buyers15min": 28,
  "buyers1h": 67,
  "buyers4h": 156,
  "buyers6h": 234,
  "buyers12h": 445,
  "buyers24h": 889,
  "sellers1min": 2,
  "sellers5min": 9,
  "sellers15min": 25,
  "sellers1h": 78,
  "sellers4h": 167,
  "sellers6h": 234,
  "sellers12h": 389,
  "sellers24h": 778,
  "traders1min": 5,
  "traders5min": 19,
  "traders15min": 53,
  "traders1h": 145,
  "traders4h": 323,
  "traders6h": 468,
  "traders12h": 834,
  "traders24h": 1667,
  "feesPaid1minUSD": 1.23,
  "feesPaid5minUSD": 5.67,
  "feesPaid15minUSD": 12.34,
  "feesPaid1hUSD": 34.56,
  "feesPaid4hUSD": 89.01,
  "feesPaid6hUSD": 123.45,
  "feesPaid12hUSD": 234.56,
  "feesPaid24hUSD": 456.78,
  "holdersCount": 1234,
  "source": "uniswap_v2",
  "deployer": "0x1234567890123456789012345678901234567890",
  "tokenSymbol": "TOKEN0-TOKEN1",
  "tokenName": "Token0 Token1 LP",
  "dexscreenerListed": true,
  "deployerMigrations": 2,
  "socials": {
    "twitter": "https://twitter.com/example",
    "website": "https://example.com",
    "telegram": "https://t.me/example",
    "others": {
      "discord": "https://discord.gg/example"
    },
    "uri": "https://example.com/socials"
  },
  "description": "A liquidity pool for TOKEN0 and TOKEN1 trading pair",
  "security": {
    "isHoneypot": false,
    "isBlacklisted": false,
    "isMalicious": false,
    "trustLevel": "high"
  },
  "twitterReusesCount": 1,
  "twitterRenameCount": 0,
  "twitterRenameHistory": [
    {
      "username": "example_old",
      "lastChecked": "2023-01-01T00:00:00.000Z"
    }
  ]
}

​
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": "0x1234567890123456789012345678901234567890"
    },
    {
      "blockchain": {"id": "evm:1"},
      "symbol": "ETH"
    }
  ]'

​
Response Format

[
  {
    "token0": {
      "address": "0x1234567890123456789012345678901234567890",
      "chainId": 1,
      "symbol": "TOKEN0",
      "name": "Token Zero",
      "decimals": 18,
      "id": 12345,
      "priceUSD": 1.2345,
      ...
    },
    "token1": {
      "address": "0x0987654321098765432109876543210987654321",
      "chainId": 1,
      "symbol": "TOKEN1",
      "name": "Token One",
      "decimals": 18,
      "id": 67890,
      "priceUSD": 0.5678,
      ...
    },
    "liquidityUSD": 1804459.12,
    "blockchain": "ethereum",
    "address": "0x1234567890123456789012345678901234567890",
    "createdAt": "2023-01-15T10:30:00.000Z",
    "type": "uniswap_v2",
    "baseToken": "0x1234567890123456789012345678901234567890",
    "exchange": {
      "name": "Uniswap",
      "logo": "https://example.com/uniswap-logo.png"
    },
    ...
  },
  {
    "token0": {
      "address": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd",
      "chainId": 56,
      "symbol": "CAKE",
      "name": "PancakeSwap",
      "decimals": 18,
      "id": 99999,
      "priceUSD": 2.3456,
      ...
    },
    "token1": {
      "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",
    "baseToken": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd",
    "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

Response

200 - application/json

Market details response

​
data
object
required