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
{
  "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
}

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):
{
  "baseToken": {
    "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"
  },
  "quoteToken": {
    "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",
  "exchange": {
    "name": "Uniswap",
    "logo": "https://example.com/uniswap-logo.png"
  },
  "factory": "0x5C69bEe701ef814a2B6a3EDD4B1652CB9cc5aA6f",
  "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

[
  {
    "baseToken": {
      "address": "0x1234567890123456789012345678901234567890",
      "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": "0x1234567890123456789012345678901234567890",
    "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

Response

200 - application/json

Market details response

base
object
required
quote
object
required
latestTradeDate
string | null
required
blockchain
string
required
address
string
required
createdAt
string | null
required
type
string
required
exchange
object
required
factory
string | null
required
baseToken
string
required
quoteToken
string
required
bondingPercentage
number | null
required
preBondingPoolAddress
string | null
required
totalFeesPaidUSD
number | null
required
source
string | null
required
deployer
string | null
required
tokenSymbol
string | null
required
tokenName
string | null
required
socials
object
required
description
string | null
required
security
required
token0
object
token1
object
liquidityUSD
number | null
default:0
priceUSD
number | null
priceToken
number | null
priceTokenString
string
bonded
boolean | null
sourceFactory
string | null
priceChange1minPercentage
number | null
default:0
priceChange5minPercentage
number | null
default:0
priceChange1hPercentage
number | null
default:0
priceChange4hPercentage
number | null
default:0
priceChange6hPercentage
number | null
default:0
priceChange12hPercentage
number | null
default:0
priceChange24hPercentage
number | null
default:0
volume1minUSD
number | null
default:0
volume5minUSD
number | null
default:0
volume15minUSD
number | null
default:0
volume1hUSD
number | null
default:0
volume4hUSD
number | null
default:0
volume6hUSD
number | null
default:0
volume12hUSD
number | null
default:0
volume24hUSD
number | null
default:0
volumeBuy1minUSD
number | null
default:0
volumeBuy5minUSD
number | null
default:0
volumeBuy15minUSD
number | null
default:0
volumeBuy1hUSD
number | null
default:0
volumeBuy4hUSD
number | null
default:0
volumeBuy6hUSD
number | null
default:0
volumeBuy12hUSD
number | null
default:0
volumeBuy24hUSD
number | null
default:0
volumeSell1minUSD
number | null
default:0
volumeSell5minUSD
number | null
default:0
volumeSell15minUSD
number | null
default:0
volumeSell1hUSD
number | null
default:0
volumeSell4hUSD
number | null
default:0
volumeSell6hUSD
number | null
default:0
volumeSell12hUSD
number | null
default:0
volumeSell24hUSD
number | null
default:0
trades1min
number | null
default:0
trades5min
number | null
default:0
trades15min
number | null
default:0
trades1h
number | null
default:0
trades4h
number | null
default:0
trades6h
number | null
default:0
trades12h
number | null
default:0
trades24h
number | null
default:0
buys1min
number | null
default:0
buys5min
number | null
default:0
buys15min
number | null
default:0
buys1h
number | null
default:0
buys4h
number | null
default:0
buys6h
number | null
default:0
buys12h
number | null
default:0
buys24h
number | null
default:0
sells1min
number | null
default:0
sells5min
number | null
default:0
sells15min
number | null
default:0
sells1h
number | null
default:0
sells4h
number | null
default:0
sells6h
number | null
default:0
sells12h
number | null
default:0
sells24h
number | null
default:0
buyers1min
number | null
default:0
buyers5min
number | null
default:0
buyers15min
number | null
default:0
buyers1h
number | null
default:0
buyers4h
number | null
default:0
buyers6h
number | null
default:0
buyers12h
number | null
default:0
buyers24h
number | null
default:0
sellers1min
number | null
default:0
sellers5min
number | null
default:0
sellers15min
number | null
default:0
sellers1h
number | null
default:0
sellers4h
number | null
default:0
sellers6h
number | null
default:0
sellers12h
number | null
default:0
sellers24h
number | null
default:0
traders1min
number | null
default:0
traders5min
number | null
default:0
traders15min
number | null
default:0
traders1h
number | null
default:0
traders4h
number | null
default:0
traders6h
number | null
default:0
traders12h
number | null
default:0
traders24h
number | null
default:0
feesPaid1minUSD
number | null
default:0
feesPaid5minUSD
number | null
default:0
feesPaid15minUSD
number | null
default:0
feesPaid1hUSD
number | null
default:0
feesPaid4hUSD
number | null
default:0
feesPaid6hUSD
number | null
default:0
feesPaid12hUSD
number | null
default:0
feesPaid24hUSD
number | null
default:0
holdersCount
number | null
dexscreenerListed
boolean | null
deployerMigrations
number | null
default:0
twitterReusesCount
number | null
default:0
twitterRenameCount
number | null
default:0
twitterRenameHistory
object[]
top10HoldingsPercentage
number | null
top50HoldingsPercentage
number | null
top100HoldingsPercentage
number | null
top200HoldingsPercentage
number | null
devHoldingsPercentage
number | null
insidersHoldingsPercentage
number | null
bundlersHoldingsPercentage
number | null
snipersHoldingsPercentage
number | null
proTradersHoldingsPercentage
number | null
freshTradersHoldingsPercentage
number | null
smartTradersHoldingsPercentage
number | null
insidersCount
number | null
bundlersCount
number | null
snipersCount
number | null
freshTradersCount
number | null
proTradersCount
number | null
smartTradersCount
number | null
freshTradersBuys
number | null
proTradersBuys
number | null
smartTradersBuys
number | null
I