​
Overview

The Token Details endpoint provides comprehensive token data including metadata, liquidity, volume, price changes, holdings, and trading activity over multiple timeframes. It supports both single-item queries (GET) and batch queries (POST) for efficient data retrieval by token address.

​
GET Method - Single Item Query

Retrieve detailed token information for a single token.

​
Query Parameters

  • blockchain (required) — The blockchain identifier (e.g., evm:1, solana, ethereum)
  • address (required) — Direct token address
  • force (optional, boolean) — Bypass cache for real-time data when true

​
Usage Examples

# Query by direct address
curl -X GET "https://api.mobula.io/api/2/token/details?blockchain=evm:1&address=0x1234..."

# Query with force refresh
curl -X GET "https://api.mobula.io/api/2/token/details?blockchain=solana&address=3vz82EWYv8xnc7Cm7qSgERcpMeqw92PcX8PBz88npump&force=true"

​
Response Format

{
  "data": {
    "address": "3vz82EWYv8xnc7Cm7qSgERcpMeqw92PcX8PBz88npump",
    "chainId": "solana",
    "symbol": "EXAMPLE",
    "name": "Example Token",
    "decimals": 9,
    "id": 12345,
    "price": 0.0234,
    "priceToken": 43.21,
    "priceTokenString": "43.210000000000000000000000000000",
    "approximateReserveUSD": 125000.50,
    "approximateReserveTokenRaw": "5000000000000000000",
    "approximateReserveToken": 5000.0,
    "totalSupply": 1000000000,
    "circulatingSupply": 800000000,
    "marketCap": 18720000,
    "marketCapDiluted": 23400000,
    "logo": "https://example.com/token-logo.png",
    "exchange": {
      "name": "Uniswap V3",
      "logo": "https://example.com/uniswap-logo.png"
    },
    "factory": "0x1F98431c8aD98523631AE4a59f267346ea31F984",
    "source": "uniswap",
    "sourceFactory": "0x1F98431c8aD98523631AE4a59f267346ea31F984",
    "liquidity": 250000.75,
    "liquidityMax": 300000.0,
    "bonded": false,
    "bondingPercentage": 0,
    "bondingCurveAddress": null,
    "preBondingFactory": null,
    "poolAddress": null,
    "top10HoldingsPercentage": 45.6,
    "top50HoldingsPercentage": 68.9,
    "top100HoldingsPercentage": 78.5,
    "top200HoldingsPercentage": 85.2,
    "devHoldingsPercentage": 15.5,
    "insidersHoldingsPercentage": 8.2,
    "bundlersHoldingsPercentage": 2.8,
    "snipersHoldingsPercentage": 3.1,
    "proTradersHoldingsPercentage": 5.0,
    "blockchain": "solana",
    "type": "token",
    "deployer": "3vz82EWYv8xnc7Cm7qSgERcpMeqw92PcX8PBz88npump",
    "createdAt": "2024-12-01T00:00:00.000Z",
    "bonded_at": null,
    "ath": 0.0456,
    "atl": 0.0012,
    "athDate": "2024-12-15T10:30:00.000Z",
    "atlDate": "2024-12-01T00:00:00.000Z",
    "latest_trade_date": "2025-01-15T10:30:00.000Z",
    "price_change_1min": 0.5,
    "price_change_5min": -1.2,
    "price_change_1h": 3.4,
    "price_change_4h": 2.1,
    "price_change_6h": 1.8,
    "price_change_12h": 0.9,
    "price_change_24h": -5.8,
    "price_1min_ago": 0.0232,
    "price_5min_ago": 0.0237,
    "price_1h_ago": 0.0225,
    "price_4h_ago": 0.0230,
    "price_6h_ago": 0.0231,
    "price_12h_ago": 0.0232,
    "price_24h_ago": 0.0247,
    "volume_1min": 1250.75,
    "volume_5min": 8500.25,
    "volume_15min": 42500.80,
    "volume_1h": 45000.80,
    "volume_4h": 180000.25,
    "volume_6h": 270000.40,
    "volume_12h": 540000.50,
    "volume_24h": 890000.50,
    "volume_buy_1min": 675.50,
    "volume_buy_5min": 4500.25,
    "volume_buy_15min": 22500.40,
    "volume_buy_1h": 24000.40,
    "volume_buy_4h": 96000.15,
    "volume_buy_6h": 144000.25,
    "volume_buy_12h": 288000.30,
    "volume_buy_24h": 480000.25,
    "volume_sell_1min": 575.25,
    "volume_sell_5min": 4000.00,
    "volume_sell_15min": 20000.40,
    "volume_sell_1h": 21000.40,
    "volume_sell_4h": 84000.10,
    "volume_sell_6h": 126000.15,
    "volume_sell_12h": 252000.20,
    "volume_sell_24h": 410000.25,
    "trades_1min": 15,
    "trades_5min": 85,
    "trades_15min": 425,
    "trades_1h": 450,
    "trades_4h": 1800,
    "trades_6h": 2700,
    "trades_12h": 5400,
    "trades_24h": 8900,
    "buys_1min": 8,
    "buys_5min": 45,
    "buys_15min": 225,
    "buys_1h": 240,
    "buys_4h": 960,
    "buys_6h": 1440,
    "buys_12h": 2880,
    "buys_24h": 4800,
    "sells_1min": 7,
    "sells_5min": 40,
    "sells_15min": 200,
    "sells_1h": 210,
    "sells_4h": 840,
    "sells_6h": 1260,
    "sells_12h": 2520,
    "sells_24h": 4100,
    "buyers_1min": 8,
    "buyers_5min": 42,
    "buyers_15min": 210,
    "buyers_1h": 235,
    "buyers_4h": 940,
    "buyers_6h": 1410,
    "buyers_12h": 2820,
    "buyers_24h": 4650,
    "sellers_1min": 7,
    "sellers_5min": 38,
    "sellers_15min": 190,
    "sellers_1h": 205,
    "sellers_4h": 820,
    "sellers_6h": 1230,
    "sellers_12h": 2460,
    "sellers_24h": 3950,
    "traders_1min": 14,
    "traders_5min": 78,
    "traders_15min": 390,
    "traders_1h": 420,
    "traders_4h": 1680,
    "traders_6h": 2520,
    "traders_12h": 5040,
    "traders_24h": 8200,
    "fees_paid_1min": 6.25,
    "fees_paid_5min": 42.5,
    "fees_paid_15min": 212.5,
    "fees_paid_1h": 225.0,
    "fees_paid_4h": 900.0,
    "fees_paid_6h": 1350.0,
    "fees_paid_12h": 2700.0,
    "fees_paid_24h": 4450.0,
    "totalFeesPaidUSD": 8900.0,
    "organic_trades_1min": 12,
    "organic_trades_5min": 68,
    "organic_trades_15min": 340,
    "organic_trades_1h": 360,
    "organic_trades_4h": 1440,
    "organic_trades_6h": 2160,
    "organic_trades_12h": 4320,
    "organic_trades_24h": 7120,
    "organic_traders_1min": 11,
    "organic_traders_5min": 62,
    "organic_traders_15min": 310,
    "organic_traders_1h": 335,
    "organic_traders_4h": 1340,
    "organic_traders_6h": 2010,
    "organic_traders_12h": 4020,
    "organic_traders_24h": 6560,
    "organic_volume_1min": 1000.6,
    "organic_volume_5min": 6800.2,
    "organic_volume_15min": 34000.64,
    "organic_volume_1h": 36000.64,
    "organic_volume_4h": 144000.2,
    "organic_volume_6h": 216000.32,
    "organic_volume_12h": 432000.4,
    "organic_volume_24h": 712000.4,
    "organic_volume_buy_1min": 540.32,
    "organic_volume_buy_5min": 3600.16,
    "organic_volume_buy_15min": 18000.32,
    "organic_volume_buy_1h": 19200.32,
    "organic_volume_buy_4h": 76800.12,
    "organic_volume_buy_6h": 115200.2,
    "organic_volume_buy_12h": 230400.24,
    "organic_volume_buy_24h": 384000.2,
    "organic_volume_sell_1min": 460.28,
    "organic_volume_sell_5min": 3200.04,
    "organic_volume_sell_15min": 16000.32,
    "organic_volume_sell_1h": 16800.32,
    "organic_volume_sell_4h": 67200.08,
    "organic_volume_sell_6h": 100800.12,
    "organic_volume_sell_12h": 201600.16,
    "organic_volume_sell_24h": 328000.2,
    "organic_buys_1min": 6,
    "organic_buys_5min": 36,
    "organic_buys_15min": 180,
    "organic_buys_1h": 192,
    "organic_buys_4h": 768,
    "organic_buys_6h": 1152,
    "organic_buys_12h": 2304,
    "organic_buys_24h": 3840,
    "organic_sells_1min": 6,
    "organic_sells_5min": 32,
    "organic_sells_15min": 160,
    "organic_sells_1h": 168,
    "organic_sells_4h": 672,
    "organic_sells_6h": 1008,
    "organic_sells_12h": 2016,
    "organic_sells_24h": 3280,
    "organic_buyers_1min": 6,
    "organic_buyers_5min": 33,
    "organic_buyers_15min": 165,
    "organic_buyers_1h": 188,
    "organic_buyers_4h": 752,
    "organic_buyers_6h": 1128,
    "organic_buyers_12h": 2256,
    "organic_buyers_24h": 3720,
    "organic_sellers_1min": 6,
    "organic_sellers_5min": 30,
    "organic_sellers_15min": 152,
    "organic_sellers_1h": 164,
    "organic_sellers_4h": 656,
    "organic_sellers_6h": 984,
    "organic_sellers_12h": 1968,
    "organic_sellers_24h": 3168,
    "created_at": "2024-12-01T00:00:00.000Z",
    "latest_price": 0.0234,
    "holders_count": 1250,
    "market_cap": 18720000,
    "latest_market_cap": 18720000,
    "description": "Example token description",
    "socials": {
      "twitter": "https://twitter.com/example",
      "website": "https://example.com",
      "telegram": "https://t.me/example",
      "others": {},
      "uri": "https://example.com/token"
    },
    "security": {
      "honeypot": false,
      "rugPull": false,
      "scam": false,
      "verified": true
    },
    "twitterReusesCount": 0,
    "twitterRenameCount": 0,
    "twitterRenameHistory": [],
    "deployerMigrationsCount": 0,
    "dexscreenerListed": true,
    "dexscreenerHeader": null,
    "dexscreenerAdPaid": false,
    "holders_list": [
      {
        "address": "3vz82EWYv8xnc7Cm7qSgERcpMeqw92PcX8PBz88npump",
        "balance": 1000000.0,
        "nativeBalance": 0.5,
        "balanceUsd": 23400.0,
        "boughtAmount": 500000.0,
        "soldAmount": 250000.0,
        "pnl": 11700.0
      }
    ]
  }
}

​
POST Method - Batch Query

Retrieve token details for multiple tokens by address in a single request for improved efficiency.

​
Request Body

[
  {
    "blockchain": {
      "id": "evm:1",
      "name": "ethereum"
    },
    "address": "0x1234567890123456789012345678901234567890"
  },
  {
    "blockchain": {
      "id": "solana",
      "name": "solana"
    },
    "address": "3vz82EWYv8xnc7Cm7qSgERcpMeqw92PcX8PBz88npump"
  }
]

​
Body Parameters

The request body is an array of query objects, where each object contains:
  • blockchain (required) — Blockchain configuration object:
    • id — Chain identifier (e.g., evm:1, evm:56, solana)
    • name — Human-readable chain name (optional)
  • address (required) — Direct token address
Note: Each array item must specify the address.

​
Usage Examples

# Batch query by addresses
curl -X POST "https://api.mobula.io/api/2/token/details" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "blockchain": {"id": "evm:1"},
      "address": "0x1234567890123456789012345678901234567890"
    },
    {
      "blockchain": {"id": "solana"},
      "address": "3vz82EWYv8xnc7Cm7qSgERcpMeqw92PcX8PBz88npump"
    }
  ]'

​
Response Format

{
  "payload": [
    {
      "address": "0x1234567890abcdef1234567890abcdef12345678",
      "chainId": "evm:1",
      "symbol": "WBTC",
      "name": "Wrapped Bitcoin",
      "decimals": 8,
      "id": 12345,
      "price": 45000.50,
      "priceToken": 1.0,
      "priceTokenString": "1.000000000000000000000000000000",
      "approximateReserveUSD": 90000000.0,
      "approximateReserveTokenRaw": "2000000000000000000",
      "approximateReserveToken": 2000.0,
      "totalSupply": 2000000,
      "circulatingSupply": 1950000,
      "marketCap": 87750000,
      "marketCapDiluted": 90000000,
      "logo": "https://example.com/wbtc-logo.png",
      "exchange": {
        "name": "Uniswap V3",
        "logo": "https://example.com/uniswap-logo.png"
      },
      "factory": "0x1F98431c8aD98523631AE4a59f267346ea31F984",
      "source": "uniswap",
      "sourceFactory": "0x1F98431c8aD98523631AE4a59f267346ea31F984",
      "liquidity": 1000000.0,
      "liquidityMax": 1200000.0,
      "bonded": false,
      "bondingPercentage": 0,
      "bondingCurveAddress": null,
      "preBondingFactory": null,
      "poolAddress": null,
      "top10HoldingsPercentage": 25.3,
      "top50HoldingsPercentage": 45.6,
      "top100HoldingsPercentage": 58.7,
      "top200HoldingsPercentage": 68.9,
      "devHoldingsPercentage": 2.1,
      "insidersHoldingsPercentage": 1.8,
      "bundlersHoldingsPercentage": 0.5,
      "snipersHoldingsPercentage": 1.2,
      "proTradersHoldingsPercentage": 3.5,
      "blockchain": "ethereum",
      "type": "token",
      "deployer": "0x1234567890abcdef...",
      "createdAt": "2020-01-01T00:00:00.000Z",
      "bonded_at": null,
      "ath": 69000.0,
      "atl": 3000.0,
      "athDate": "2021-11-10T14:00:00.000Z",
      "atlDate": "2020-01-01T00:00:00.000Z",
      "latest_trade_date": "2025-01-15T10:30:00.000Z",
      "price_change_1min": 0.1,
      "price_change_5min": -0.2,
      "price_change_1h": 0.5,
      "price_change_4h": 1.2,
      "price_change_6h": 0.8,
      "price_change_12h": -0.3,
      "price_change_24h": -2.1,
      "price_1min_ago": 44995.5,
      "price_5min_ago": 45009.5,
      "price_1h_ago": 44777.75,
      "price_4h_ago": 44466.0,
      "price_6h_ago": 44641.0,
      "price_12h_ago": 45136.5,
      "price_24h_ago": 45976.05,
      "volume_1min": 25000.0,
      "volume_5min": 125000.0,
      "volume_15min": 625000.0,
      "volume_1h": 750000.0,
      "volume_4h": 3000000.0,
      "volume_6h": 4500000.0,
      "volume_12h": 9000000.0,
      "volume_24h": 15000000.0,
      "volume_buy_1min": 13500.0,
      "volume_buy_5min": 67500.0,
      "volume_buy_15min": 337500.0,
      "volume_buy_1h": 405000.0,
      "volume_buy_4h": 1620000.0,
      "volume_buy_6h": 2430000.0,
      "volume_buy_12h": 4860000.0,
      "volume_buy_24h": 8100000.0,
      "volume_sell_1min": 11500.0,
      "volume_sell_5min": 57500.0,
      "volume_sell_15min": 287500.0,
      "volume_sell_1h": 345000.0,
      "volume_sell_4h": 1380000.0,
      "volume_sell_6h": 2070000.0,
      "volume_sell_12h": 4140000.0,
      "volume_sell_24h": 6900000.0,
      "trades_1min": 30,
      "trades_5min": 150,
      "trades_15min": 750,
      "trades_1h": 900,
      "trades_4h": 3600,
      "trades_6h": 5400,
      "trades_12h": 10800,
      "trades_24h": 18000,
      "buys_1min": 16,
      "buys_5min": 80,
      "buys_15min": 400,
      "buys_1h": 480,
      "buys_4h": 1920,
      "buys_6h": 2880,
      "buys_12h": 5760,
      "buys_24h": 9600,
      "sells_1min": 14,
      "sells_5min": 70,
      "sells_15min": 350,
      "sells_1h": 420,
      "sells_4h": 1680,
      "sells_6h": 2520,
      "sells_12h": 5040,
      "sells_24h": 8400,
      "buyers_1min": 16,
      "buyers_5min": 76,
      "buyers_15min": 380,
      "buyers_1h": 455,
      "buyers_4h": 1820,
      "buyers_6h": 2730,
      "buyers_12h": 5460,
      "buyers_24h": 9100,
      "sellers_1min": 14,
      "sellers_5min": 67,
      "sellers_15min": 335,
      "sellers_1h": 400,
      "sellers_4h": 1600,
      "sellers_6h": 2400,
      "sellers_12h": 4800,
      "sellers_24h": 8000,
      "traders_1min": 28,
      "traders_5min": 140,
      "traders_15min": 700,
      "traders_1h": 840,
      "traders_4h": 3360,
      "traders_6h": 5040,
      "traders_12h": 10080,
      "traders_24h": 16800,
      "fees_paid_1min": 125.0,
      "fees_paid_5min": 625.0,
      "fees_paid_15min": 3125.0,
      "fees_paid_1h": 3750.0,
      "fees_paid_4h": 15000.0,
      "fees_paid_6h": 22500.0,
      "fees_paid_12h": 45000.0,
      "fees_paid_24h": 75000.0,
      "totalFeesPaidUSD": 150000.0,
      "organic_trades_1min": 24,
      "organic_trades_5min": 120,
      "organic_trades_15min": 600,
      "organic_trades_1h": 720,
      "organic_trades_4h": 2880,
      "organic_trades_6h": 4320,
      "organic_trades_12h": 8640,
      "organic_trades_24h": 14400,
      "organic_traders_1min": 22,
      "organic_traders_5min": 112,
      "organic_traders_15min": 560,
      "organic_traders_1h": 672,
      "organic_traders_4h": 2688,
      "organic_traders_6h": 4032,
      "organic_traders_12h": 8064,
      "organic_traders_24h": 13440,
      "organic_volume_1min": 20000.0,
      "organic_volume_5min": 100000.0,
      "organic_volume_15min": 500000.0,
      "organic_volume_1h": 600000.0,
      "organic_volume_4h": 2400000.0,
      "organic_volume_6h": 3600000.0,
      "organic_volume_12h": 7200000.0,
      "organic_volume_24h": 12000000.0,
      "organic_volume_buy_1min": 10800.0,
      "organic_volume_buy_5min": 54000.0,
      "organic_volume_buy_15min": 270000.0,
      "organic_volume_buy_1h": 324000.0,
      "organic_volume_buy_4h": 1296000.0,
      "organic_volume_buy_6h": 1944000.0,
      "organic_volume_buy_12h": 3888000.0,
      "organic_volume_buy_24h": 6480000.0,
      "organic_volume_sell_1min": 9200.0,
      "organic_volume_sell_5min": 46000.0,
      "organic_volume_sell_15min": 230000.0,
      "organic_volume_sell_1h": 276000.0,
      "organic_volume_sell_4h": 1104000.0,
      "organic_volume_sell_6h": 1656000.0,
      "organic_volume_sell_12h": 3312000.0,
      "organic_volume_sell_24h": 5520000.0,
      "organic_buys_1min": 12,
      "organic_buys_5min": 64,
      "organic_buys_15min": 320,
      "organic_buys_1h": 384,
      "organic_buys_4h": 1536,
      "organic_buys_6h": 2304,
      "organic_buys_12h": 4608,
      "organic_buys_24h": 7680,
      "organic_sells_1min": 12,
      "organic_sells_5min": 56,
      "organic_sells_15min": 280,
      "organic_sells_1h": 336,
      "organic_sells_4h": 1344,
      "organic_sells_6h": 2016,
      "organic_sells_12h": 4032,
      "organic_sells_24h": 6720,
      "organic_buyers_1min": 12,
      "organic_buyers_5min": 61,
      "organic_buyers_15min": 305,
      "organic_buyers_1h": 364,
      "organic_buyers_4h": 1456,
      "organic_buyers_6h": 2184,
      "organic_buyers_12h": 4368,
      "organic_buyers_24h": 7280,
      "organic_sellers_1min": 12,
      "organic_sellers_5min": 54,
      "organic_sellers_15min": 270,
      "organic_sellers_1h": 320,
      "organic_sellers_4h": 1280,
      "organic_sellers_6h": 1920,
      "organic_sellers_12h": 3840,
      "organic_sellers_24h": 6400,
      "created_at": "2020-01-01T00:00:00.000Z",
      "latest_price": 45000.50,
      "holders_count": 2500,
      "market_cap": 87750000,
      "latest_market_cap": 87750000,
      "description": "Wrapped Bitcoin token description",
      "socials": {
        "twitter": "https://twitter.com/wbtc",
        "website": "https://wbtc.network",
        "telegram": "https://t.me/wbtc",
        "others": {},
        "uri": "https://wbtc.network"
      },
      "security": {
        "honeypot": false,
        "rugPull": false,
        "scam": false,
        "verified": true
      },
      "twitterReusesCount": 0,
      "twitterRenameCount": 0,
      "twitterRenameHistory": [],
      "deployerMigrationsCount": 0,
      "dexscreenerListed": true,
      "dexscreenerHeader": null,
      "dexscreenerAdPaid": false,
      "holders_list": [
        {
          "address": "0x1234567890abcdef...",
          "balance": 100.0,
          "nativeBalance": 0.1,
          "balanceUsd": 4500050.0,
          "boughtAmount": 50.0,
          "soldAmount": 25.0,
          "pnl": 2250025.0
        }
      ]
    },
    {
      "address": "3vz82EWYv8xnc7Cm7qSgERcpMeqw92PcX8PBz88npump",
      "chainId": "solana",
      "symbol": "EXAMPLE",
      "name": "Example Token",
      "decimals": 9,
      "id": 67890,
      "price": 0.0234,
      "priceToken": 43.21,
      "priceTokenString": "43.210000000000000000000000000000",
      "approximateReserveUSD": 125000.50,
      "approximateReserveTokenRaw": "5000000000000000000",
      "approximateReserveToken": 5000.0,
      "totalSupply": 1000000000,
      "circulatingSupply": 800000000,
      "marketCap": 18720000,
      "marketCapDiluted": 23400000,
      "logo": "https://example.com/token-logo.png",
      "exchange": {
        "name": "Raydium",
        "logo": "https://example.com/raydium-logo.png"
      },
      "factory": "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8",
      "source": "raydium",
      "sourceFactory": "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8",
      "liquidity": 250000.75,
      "liquidityMax": 300000.0,
      "bonded": false,
      "bondingPercentage": 0,
      "bondingCurveAddress": null,
      "preBondingFactory": null,
      "poolAddress": null,
      "top10HoldingsPercentage": 45.6,
      "top50HoldingsPercentage": 68.9,
      "top100HoldingsPercentage": 78.5,
      "top200HoldingsPercentage": 85.2,
      "devHoldingsPercentage": 15.5,
      "insidersHoldingsPercentage": 8.2,
      "bundlersHoldingsPercentage": 2.8,
      "snipersHoldingsPercentage": 3.1,
      "proTradersHoldingsPercentage": 5.0,
      "blockchain": "solana",
      "type": "token",
      "deployer": "3vz82EWYv8xnc7Cm7qSgERcpMeqw92PcX8PBz88npump",
      "createdAt": "2024-12-01T00:00:00.000Z",
      "bonded_at": null,
      "ath": 0.0456,
      "atl": 0.0012,
      "athDate": "2024-12-15T10:30:00.000Z",
      "atlDate": "2024-12-01T00:00:00.000Z",
      "latest_trade_date": "2025-01-15T10:30:00.000Z",
      "price_change_1min": 0.5,
      "price_change_5min": -1.2,
      "price_change_1h": 3.4,
      "price_change_4h": 2.1,
      "price_change_6h": 1.8,
      "price_change_12h": 0.9,
      "price_change_24h": -5.8,
      "price_1min_ago": 0.0232,
      "price_5min_ago": 0.0237,
      "price_1h_ago": 0.0225,
      "price_4h_ago": 0.0230,
      "price_6h_ago": 0.0231,
      "price_12h_ago": 0.0232,
      "price_24h_ago": 0.0247,
      "volume_1min": 1250.75,
      "volume_5min": 8500.25,
      "volume_15min": 42500.80,
      "volume_1h": 45000.80,
      "volume_4h": 180000.25,
      "volume_6h": 270000.40,
      "volume_12h": 540000.50,
      "volume_24h": 890000.50,
      "volume_buy_1min": 675.50,
      "volume_buy_5min": 4500.25,
      "volume_buy_15min": 22500.40,
      "volume_buy_1h": 24000.40,
      "volume_buy_4h": 96000.15,
      "volume_buy_6h": 144000.25,
      "volume_buy_12h": 288000.30,
      "volume_buy_24h": 480000.25,
      "volume_sell_1min": 575.25,
      "volume_sell_5min": 4000.00,
      "volume_sell_15min": 20000.40,
      "volume_sell_1h": 21000.40,
      "volume_sell_4h": 84000.10,
      "volume_sell_6h": 126000.15,
      "volume_sell_12h": 252000.20,
      "volume_sell_24h": 410000.25,
      "trades_1min": 15,
      "trades_5min": 85,
      "trades_15min": 425,
      "trades_1h": 450,
      "trades_4h": 1800,
      "trades_6h": 2700,
      "trades_12h": 5400,
      "trades_24h": 8900,
      "buys_1min": 8,
      "buys_5min": 45,
      "buys_15min": 225,
      "buys_1h": 240,
      "buys_4h": 960,
      "buys_6h": 1440,
      "buys_12h": 2880,
      "buys_24h": 4800,
      "sells_1min": 7,
      "sells_5min": 40,
      "sells_15min": 200,
      "sells_1h": 210,
      "sells_4h": 840,
      "sells_6h": 1260,
      "sells_12h": 2520,
      "sells_24h": 4100,
      "buyers_1min": 8,
      "buyers_5min": 42,
      "buyers_15min": 210,
      "buyers_1h": 235,
      "buyers_4h": 940,
      "buyers_6h": 1410,
      "buyers_12h": 2820,
      "buyers_24h": 4650,
      "sellers_1min": 7,
      "sellers_5min": 38,
      "sellers_15min": 190,
      "sellers_1h": 205,
      "sellers_4h": 820,
      "sellers_6h": 1230,
      "sellers_12h": 2460,
      "sellers_24h": 3950,
      "traders_1min": 14,
      "traders_5min": 78,
      "traders_15min": 390,
      "traders_1h": 420,
      "traders_4h": 1680,
      "traders_6h": 2520,
      "traders_12h": 5040,
      "traders_24h": 8200,
      "fees_paid_1min": 6.25,
      "fees_paid_5min": 42.5,
      "fees_paid_15min": 212.5,
      "fees_paid_1h": 225.0,
      "fees_paid_4h": 900.0,
      "fees_paid_6h": 1350.0,
      "fees_paid_12h": 2700.0,
      "fees_paid_24h": 4450.0,
      "totalFeesPaidUSD": 8900.0,
      "organic_trades_1min": 12,
      "organic_trades_5min": 68,
      "organic_trades_15min": 340,
      "organic_trades_1h": 360,
      "organic_trades_4h": 1440,
      "organic_trades_6h": 2160,
      "organic_trades_12h": 4320,
      "organic_trades_24h": 7120,
      "organic_traders_1min": 11,
      "organic_traders_5min": 62,
      "organic_traders_15min": 310,
      "organic_traders_1h": 335,
      "organic_traders_4h": 1340,
      "organic_traders_6h": 2010,
      "organic_traders_12h": 4020,
      "organic_traders_24h": 6560,
      "organic_volume_1min": 1000.6,
      "organic_volume_5min": 6800.2,
      "organic_volume_15min": 34000.64,
      "organic_volume_1h": 36000.64,
      "organic_volume_4h": 144000.2,
      "organic_volume_6h": 216000.32,
      "organic_volume_12h": 432000.4,
      "organic_volume_24h": 712000.4,
      "organic_volume_buy_1min": 540.32,
      "organic_volume_buy_5min": 3600.16,
      "organic_volume_buy_15min": 18000.32,
      "organic_volume_buy_1h": 19200.32,
      "organic_volume_buy_4h": 76800.12,
      "organic_volume_buy_6h": 115200.2,
      "organic_volume_buy_12h": 230400.24,
      "organic_volume_buy_24h": 384000.2,
      "organic_volume_sell_1min": 460.28,
      "organic_volume_sell_5min": 3200.04,
      "organic_volume_sell_15min": 16000.32,
      "organic_volume_sell_1h": 16800.32,
      "organic_volume_sell_4h": 67200.08,
      "organic_volume_sell_6h": 100800.12,
      "organic_volume_sell_12h": 201600.16,
      "organic_volume_sell_24h": 328000.2,
      "organic_buys_1min": 6,
      "organic_buys_5min": 36,
      "organic_buys_15min": 180,
      "organic_buys_1h": 192,
      "organic_buys_4h": 768,
      "organic_buys_6h": 1152,
      "organic_buys_12h": 2304,
      "organic_buys_24h": 3840,
      "organic_sells_1min": 6,
      "organic_sells_5min": 32,
      "organic_sells_15min": 160,
      "organic_sells_1h": 168,
      "organic_sells_4h": 672,
      "organic_sells_6h": 1008,
      "organic_sells_12h": 2016,
      "organic_sells_24h": 3280,
      "organic_buyers_1min": 6,
      "organic_buyers_5min": 33,
      "organic_buyers_15min": 165,
      "organic_buyers_1h": 188,
      "organic_buyers_4h": 752,
      "organic_buyers_6h": 1128,
      "organic_buyers_12h": 2256,
      "organic_buyers_24h": 3720,
      "organic_sellers_1min": 6,
      "organic_sellers_5min": 30,
      "organic_sellers_15min": 152,
      "organic_sellers_1h": 164,
      "organic_sellers_4h": 656,
      "organic_sellers_6h": 984,
      "organic_sellers_12h": 1968,
      "organic_sellers_24h": 3168,
      "created_at": "2024-12-01T00:00:00.000Z",
      "latest_price": 0.0234,
      "holders_count": 1250,
      "market_cap": 18720000,
      "latest_market_cap": 18720000,
      "description": "Example token description",
      "socials": {
        "twitter": "https://twitter.com/example",
        "website": "https://example.com",
        "telegram": "https://t.me/example",
        "others": {},
        "uri": "https://example.com/token"
      },
      "security": {
        "honeypot": false,
        "rugPull": false,
        "scam": false,
        "verified": true
      },
      "twitterReusesCount": 0,
      "twitterRenameCount": 0,
      "twitterRenameHistory": [],
      "deployerMigrationsCount": 0,
      "dexscreenerListed": true,
      "dexscreenerHeader": null,
      "dexscreenerAdPaid": false,
      "holders_list": [
        {
          "address": "3vz82EWYv8xnc7Cm7qSgERcpMeqw92PcX8PBz88npump",
          "balance": 1000000.0,
          "nativeBalance": 0.5,
          "balanceUsd": 23400.0,
          "boughtAmount": 500000.0,
          "soldAmount": 250000.0,
          "pnl": 11700.0
        }
      ]
    }
  ]
}
📋 Schema Documentation: Complete and automatically generated schema documentation for input parameters, response structures, and all nested data types is available in the OpenAPI specification.

​
Data Models

The complete data model definitions are automatically generated from the Zod schemas and available in the OpenAPI specification. The main response types are:

​
EnrichedTokenData

Comprehensive token information including metadata, supply, market cap, volume, price changes, holdings data, and trading activity. 🔗 View Complete Schemas: OpenAPI Specification → Components → Schemas

​
Performance Notes

  • GET method: Best for single token queries and real-time data
  • POST method: Optimized for batch operations, reducing API calls
  • Batch processing: Uses efficient database queries for multiple tokens
  • Caching: Both methods support cache bypass with force=true

​
Error Handling

  • 400 Bad Request: Invalid parameters or missing required fields
  • 404 Not Found: No valid data found for the requested tokens
  • Rate limiting applies to both methods

​
Use Cases

  • GET: Single token monitoring by address, real-time price checks, detailed token analysis
  • POST: Portfolio analysis by addresses, bulk token research, multi-token dashboard data