Skip to main content
GET
/
2
/
token
/
details
Get Comprehensive Token Details
curl --request GET \
  --url https://demo-api.mobula.io/api/2/token/details
{
  "data": {
    "address": "<string>",
    "chainId": "<unknown>",
    "symbol": "<string>",
    "name": "<string>",
    "priceTokenString": "<string>",
    "approximateReserveTokenRaw": "<string>",
    "logo": "<string>",
    "bondedAt": "<string>",
    "createdAt": "<string>",
    "latestTradeDate": "<string>",
    "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>"
    },
    "decimals": 0,
    "id": null,
    "priceUSD": 0,
    "priceToken": 0,
    "approximateReserveUSD": 0,
    "approximateReserveToken": 0,
    "totalSupply": 0,
    "circulatingSupply": 0,
    "marketCapUSD": 0,
    "marketCapDilutedUSD": 0,
    "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>",
    "athUSD": 123,
    "atlUSD": 123,
    "athDate": "<string>",
    "atlDate": "<string>",
    "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,
    "totalFeesPaidUSD": 0,
    "organicTrades1min": 0,
    "organicTrades5min": 0,
    "organicTrades15min": 0,
    "organicTrades1h": 0,
    "organicTrades4h": 0,
    "organicTrades6h": 0,
    "organicTrades12h": 0,
    "organicTrades24h": 0,
    "organicTraders1min": 0,
    "organicTraders5min": 0,
    "organicTraders15min": 0,
    "organicTraders1h": 0,
    "organicTraders4h": 0,
    "organicTraders6h": 0,
    "organicTraders12h": 0,
    "organicTraders24h": 0,
    "organicVolume1minUSD": 0,
    "organicVolume5minUSD": 0,
    "organicVolume15minUSD": 0,
    "organicVolume1hUSD": 0,
    "organicVolume4hUSD": 0,
    "organicVolume6hUSD": 0,
    "organicVolume12hUSD": 0,
    "organicVolume24hUSD": 0,
    "organicVolumeBuy1minUSD": 0,
    "organicVolumeBuy5minUSD": 0,
    "organicVolumeBuy15minUSD": 0,
    "organicVolumeBuy1hUSD": 0,
    "organicVolumeBuy4hUSD": 0,
    "organicVolumeBuy6hUSD": 0,
    "organicVolumeBuy12hUSD": 0,
    "organicVolumeBuy24hUSD": 0,
    "organicVolumeSell1minUSD": 0,
    "organicVolumeSell5minUSD": 0,
    "organicVolumeSell15minUSD": 0,
    "organicVolumeSell1hUSD": 0,
    "organicVolumeSell4hUSD": 0,
    "organicVolumeSell6hUSD": 0,
    "organicVolumeSell12hUSD": 0,
    "organicVolumeSell24hUSD": 0,
    "organicBuys1min": 0,
    "organicBuys5min": 0,
    "organicBuys15min": 0,
    "organicBuys1h": 0,
    "organicBuys4h": 0,
    "organicBuys6h": 0,
    "organicBuys12h": 0,
    "organicBuys24h": 0,
    "organicSells1min": 0,
    "organicSells5min": 0,
    "organicSells15min": 0,
    "organicSells1h": 0,
    "organicSells4h": 0,
    "organicSells6h": 0,
    "organicSells12h": 0,
    "organicSells24h": 0,
    "organicBuyers1min": 0,
    "organicBuyers5min": 0,
    "organicBuyers15min": 0,
    "organicBuyers1h": 0,
    "organicBuyers4h": 0,
    "organicBuyers6h": 0,
    "organicBuyers12h": 0,
    "organicBuyers24h": 0,
    "organicSellers1min": 0,
    "organicSellers5min": 0,
    "organicSellers15min": 0,
    "organicSellers1h": 0,
    "organicSellers4h": 0,
    "organicSellers6h": 0,
    "organicSellers12h": 0,
    "organicSellers24h": 0,
    "holdersCount": 123,
    "twitterReusesCount": 0,
    "twitterRenameCount": 0,
    "twitterRenameHistory": [],
    "deployerMigrationsCount": 0,
    "dexscreenerListed": false,
    "dexscreenerHeader": null,
    "dexscreenerAdPaid": false,
    "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 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

​
Usage Examples

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

​
Response Format

{
  "data": {
    "address": "3vz82EWYv8xnc7Cm7qSgERcpMeqw92PcX8PBz88npump",
    "chainId": "solana",
    "symbol": "EXAMPLE",
    "name": "Example Token",
    "decimals": 9,
    "id": 12345,
    "priceUSD": 0.0234,
    "priceToken": 43.21,
    "priceTokenString": "43.210000000000000000000000000000",
    "approximateReserveUSD": 125000.50,
    "approximateReserveTokenRaw": "5000000000000000000",
    "approximateReserveToken": 5000.0,
    "totalSupply": 1000000000,
    "circulatingSupply": 800000000,
    "marketCapUSD": 18720000,
    "marketCapDilutedUSD": 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",
    "liquidityUSD": 250000.75,
    "liquidityMaxUSD": 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",
    "bondedAt": null,
    "athUSD": 0.0456,
    "atlUSD": 0.0012,
    "athDate": "2024-12-15T10:30:00.000Z",
    "atlDate": "2024-12-01T00:00:00.000Z",
    "priceChange1minPercentage": 0.5,
    "priceChange5minPercentage": -1.2,
    "priceChange1hPercentage": 3.4,
    "priceChange4hPercentage": 2.1,
    "priceChange6hPercentage": 1.8,
    "priceChange12hPercentage": 0.9,
    "priceChange24hPercentage": -5.8,
    "volume1minUSD": 1250.75,
    "volume5minUSD": 8500.25,
    "volume15minUSD": 42500.80,
    "volume1hUSD": 45000.80,
    "volume4hUSD": 180000.25,
    "volume6hUSD": 270000.40,
    "volume12hUSD": 540000.50,
    "volume24hUSD": 890000.50,
    "volumeBuy1minUSD": 675.50,
    "volumeBuy5minUSD": 4500.25,
    "volumeBuy15minUSD": 22500.40,
    "volumeBuy1hUSD": 24000.40,
    "volumeBuy4hUSD": 96000.15,
    "volumeBuy6hUSD": 144000.25,
    "volumeBuy12hUSD": 288000.30,
    "volumeBuy24hUSD": 480000.25,
    "volumeSell1minUSD": 575.25,
    "volumeSell5minUSD": 4000.00,
    "volumeSell15minUSD": 20000.40,
    "volumeSell1hUSD": 21000.40,
    "volumeSell4hUSD": 84000.10,
    "volumeSell6hUSD": 126000.15,
    "volumeSell12hUSD": 252000.20,
    "volumeSell24hUSD": 410000.25,
    "trades1min": 15,
    "trades5min": 85,
    "trades15min": 425,
    "trades1h": 450,
    "trades4h": 1800,
    "trades6h": 2700,
    "trades12h": 5400,
    "trades24h": 8900,
    "buys1min": 8,
    "buys5min": 45,
    "buys15min": 225,
    "buys1h": 240,
    "buys4h": 960,
    "buys6h": 1440,
    "buys12h": 2880,
    "buys24h": 4800,
    "sells1min": 7,
    "sells5min": 40,
    "sells15min": 200,
    "sells1h": 210,
    "sells4h": 840,
    "sells6h": 1260,
    "sells12h": 2520,
    "sells24h": 4100,
    "buyers1min": 8,
    "buyers5min": 42,
    "buyers15min": 210,
    "buyers1h": 235,
    "buyers4h": 940,
    "buyers6h": 1410,
    "buyers12h": 2820,
    "buyers24h": 4650,
    "sellers1min": 7,
    "sellers5min": 38,
    "sellers15min": 190,
    "sellers1h": 205,
    "sellers4h": 820,
    "sellers6h": 1230,
    "sellers12h": 2460,
    "sellers24h": 3950,
    "traders1min": 14,
    "traders5min": 78,
    "traders15min": 390,
    "traders1h": 420,
    "traders4h": 1680,
    "traders6h": 2520,
    "traders12h": 5040,
    "traders24h": 8200,
    "feesPaid1minUSD": 6.25,
    "feesPaid5minUSD": 42.5,
    "feesPaid15minUSD": 212.5,
    "feesPaid1hUSD": 225.0,
    "feesPaid4hUSD": 900.0,
    "feesPaid6hUSD": 1350.0,
    "feesPaid12hUSD": 2700.0,
    "feesPaid24hUSD": 4450.0,
    "totalFeesPaidUSD": 8900.0,
    "organicTrades1min": 12,
    "organicTrades5min": 68,
    "organicTrades15min": 340,
    "organicTrades1h": 360,
    "organicTrades4h": 1440,
    "organicTrades6h": 2160,
    "organicTrades12h": 4320,
    "organicTrades24h": 7120,
    "organicTraders1min": 11,
    "organicTraders5min": 62,
    "organicTraders15min": 310,
    "organicTraders1h": 335,
    "organicTraders4h": 1340,
    "organicTraders6h": 2010,
    "organicTraders12h": 4020,
    "organicTraders24h": 6560,
    "organicVolume1minUSD": 1000.6,
    "organicVolume5minUSD": 6800.2,
    "organicVolume15minUSD": 34000.64,
    "organicVolume1hUSD": 36000.64,
    "organicVolume4hUSD": 144000.2,
    "organicVolume6hUSD": 216000.32,
    "organicVolume12hUSD": 432000.4,
    "organicVolume24hUSD": 712000.4,
    "organicVolumeBuy1minUSD": 540.32,
    "organicVolumeBuy5minUSD": 3600.16,
    "organicVolumeBuy15minUSD": 18000.32,
    "organicVolumeBuy1hUSD": 19200.32,
    "organicVolumeBuy4hUSD": 76800.12,
    "organicVolumeBuy6hUSD": 115200.2,
    "organicVolumeBuy12hUSD": 230400.24,
    "organicVolumeBuy24hUSD": 384000.2,
    "organicVolumeSell1minUSD": 460.28,
    "organicVolumeSell5minUSD": 3200.04,
    "organicVolumeSell15minUSD": 16000.32,
    "organicVolumeSell1hUSD": 16800.32,
    "organicVolumeSell4hUSD": 67200.08,
    "organicVolumeSell6hUSD": 100800.12,
    "organicVolumeSell12hUSD": 201600.16,
    "organicVolumeSell24hUSD": 328000.2,
    "organicBuys1min": 6,
    "organicBuys5min": 36,
    "organicBuys15min": 180,
    "organicBuys1h": 192,
    "organicBuys4h": 768,
    "organicBuys6h": 1152,
    "organicBuys12h": 2304,
    "organicBuys24h": 3840,
    "organicSells1min": 6,
    "organicSells5min": 32,
    "organicSells15min": 160,
    "organicSells1h": 168,
    "organicSells4h": 672,
    "organicSells6h": 1008,
    "organicSells12h": 2016,
    "organicSells24h": 3280,
    "organicBuyers1min": 6,
    "organicBuyers5min": 33,
    "organicBuyers15min": 165,
    "organicBuyers1h": 188,
    "organicBuyers4h": 752,
    "organicBuyers6h": 1128,
    "organicBuyers12h": 2256,
    "organicBuyers24h": 3720,
    "organicSellers1min": 6,
    "organicSellers5min": 30,
    "organicSellers15min": 152,
    "organicSellers1h": 164,
    "organicSellers4h": 656,
    "organicSellers6h": 984,
    "organicSellers12h": 1968,
    "organicSellers24h": 3168,
    "createdAt": "2024-12-01T00:00:00.000Z",
    "holdersCount": 1250,
    "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": {
      "isHoneypot": false,
      "isBlacklisted": false,
      "isMalicious": false,
      "trustLevel": "high"
    },
    "twitterReusesCount": 0,
    "twitterRenameCount": 0,
    "twitterRenameHistory": [],
    "deployerMigrationsCount": 0,
    "dexscreenerListed": true,
    "dexscreenerHeader": null,
    "dexscreenerAdPaid": false
  }
}

​
POST Method - Batch Query

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

​
Request Body

[
  {
    "blockchain": "evm:1",
    "address": "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599"
  },
  {
    "blockchain": "solana",
    "address": "3vz82EWYv8xnc7Cm7qSgERcpMeqw92PcX8PBz88npump"
  }
]

​
Body Parameters

The request body is an array of query objects, where each object contains:
  • blockchain (required) — Blockchain id or name
  • address (required) — Direct token address

​
Usage Examples

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

​
Response Format

{
  "payload": [
    {
      "address": "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599",
      "chainId": "evm:1",
      "symbol": "WBTC",
      "name": "Wrapped Bitcoin",
      "decimals": 8,
      "priceUSD": 45000.50,
      "marketCapUSD": 87750000,
      ...
    },
    {
      "address": "3vz82EWYv8xnc7Cm7qSgERcpMeqw92PcX8PBz88npump",
      "chainId": "solana",
      "symbol": "EXAMPLE",
      "name": "Example Token",
      "decimals": 9,
      "priceUSD": 0.0234,
      "marketCapUSD": 18720000,
      ...
    }
  ]
}

​
Use Cases

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

Query Parameters

​
blockchain
string
​
address
string
​
instanceTracking
boolean

Response

200 - application/json

Token Holder response

​
data
object
required
​
hostname
string