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": "<string>",
    "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>",
      "burnRate": "<string>",
      "liquidityBurnPercentage": 123,
      "isHoneypot": true,
      "isNotOpenSource": true,
      "renounced": true,
      "locked": "<string>",
      "isWhitelisted": true,
      "isMintable": true,
      "modifyableTax": true,
      "selfDestruct": true
    },
    "liveStatus": "<string>",
    "liveThumbnail": "<string>",
    "livestreamTitle": "<string>",
    "liveReplyCount": 123,
    "decimals": 0,
    "id": null,
    "priceUSD": 0,
    "priceToken": 0,
    "approximateReserveUSD": 0,
    "approximateReserveToken": 0,
    "totalSupply": 0,
    "circulatingSupply": 0,
    "marketCapUSD": 0,
    "marketCapDilutedUSD": 0,
    "originLogoUrl": "<string>",
    "rank": null,
    "cexs": [],
    "exchange": {
      "name": "<string>",
      "logo": "<string>"
    },
    "factory": "<string>",
    "source": "<string>",
    "sourceFactory": "<string>",
    "sourceMetadata": {
      "name": "<string>",
      "logo": "<string>"
    },
    "sourceFactoryMetadata": {
      "name": "<string>",
      "logo": "<string>"
    },
    "liquidityUSD": 123,
    "liquidityMaxUSD": 123,
    "bonded": true,
    "bondingPercentage": 123,
    "bondingCurveAddress": "<string>",
    "preBondingFactory": "<string>",
    "poolAddress": "<string>",
    "blockchain": "<string>",
    "type": "<string>",
    "tokenType": "2020",
    "deployer": "<string>",
    "athUSD": 123,
    "atlUSD": 123,
    "athDate": "<string>",
    "atlDate": "<string>",
    "priceChange1minPercentage": 0,
    "priceChange5minPercentage": 0,
    "priceChange1hPercentage": 0,
    "priceChange4hPercentage": 0,
    "priceChange6hPercentage": 0,
    "priceChange12hPercentage": 0,
    "priceChange24hPercentage": 0,
    "poolPriceChange1minPercentage": 0,
    "poolPriceChange5minPercentage": 0,
    "poolPriceChange1hPercentage": 0,
    "poolPriceChange4hPercentage": 0,
    "poolPriceChange6hPercentage": 0,
    "poolPriceChange12hPercentage": 0,
    "poolPriceChange24hPercentage": 0,
    "liquidityBurnPercentage": 123,
    "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,
    "totalFeesPaidNativeRaw": "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,
    "deployerTokensCount": 0,
    "dexscreenerListed": false,
    "dexscreenerHeader": null,
    "dexscreenerAdPaid": false,
    "dexscreenerAdPaidDate": null,
    "dexscreenerPendingAt": null,
    "dexscreenerSocialPaid": false,
    "dexscreenerSocialPaidDate": null,
    "dexscreenerBoosted": false,
    "dexscreenerBoostedDate": null,
    "dexscreenerBoostedAmount": 0,
    "trendingScore1min": 0,
    "trendingScore5min": 0,
    "trendingScore15min": 0,
    "trendingScore1h": 0,
    "trendingScore4h": 0,
    "trendingScore6h": 0,
    "trendingScore12h": 0,
    "trendingScore24h": 0,
    "surgeScore": null,
    "isMayhemMode": null,
    "isCashbackCoin": null,
    "isAgentMode": null,
    "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>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.mobula.io/llms.txt

Use this file to discover all available pages before exploring further.

Batch Support Available: This endpoint supports batch queries via POST method for fetching multiple tokens in a single request. Jump to Batch Query section

​
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
  • currencies (optional) — Comma-separated list of fiat currencies for price conversion. Defaults to USD. Supported currencies: USD, EUR, GBP, JPY, CHF, CAD, AUD, CNY, KRW, INR, BRL

​
Step-by-Step Tutorial and Video Walkthrough

  • Check out the guide: Here

​
Usage Examples

# Default (USD only)
curl -X GET "https://api.mobula.io/api/2/token/details?blockchain=solana&address=3vz82EWYv8xnc7Cm7qSgERcpMeqw92PcX8PBz88npump"

# Multi-currency (USD and EUR)
curl -X GET "https://api.mobula.io/api/2/token/details?blockchain=solana&address=3vz82EWYv8xnc7Cm7qSgERcpMeqw92PcX8PBz88npump&currencies=EUR,USD"

​
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",
    "originLogoUrl": "https://ipfs.io/ipfs/QmOriginalLogo123",
    "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,
    "freshTradersHoldingsPercentage": 1.2,
    "insidersCount": 12,
    "bundlersCount": 5,
    "snipersCount": 8,
    "freshTradersCount": 25,
    "proTradersCount": 15,
    "blockchain": "solana",
    "type": "token",
    "deployer": "3vz82EWYv8xnc7Cm7qSgERcpMeqw92PcX8PBz88npump",
    "bondedAt": null,
    "isMayhemMode": false,
    "isCashbackCoin": true,
    "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,
    "liquidityBurnPercentage": 100,
    "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",
    "latestTradeDate": "2026-02-23T10:30: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": {
      "buyTax": "5.00",
      "sellTax": "10.00",
      "transferPausable": false,
      "top10Holders": "42.50",
      "isBlacklisted": false,
      "isHoneypot": false,
      "isNotOpenSource": false,
      "renounced": true,
      "locked": "80.00",
      "isWhitelisted": false,
      "balanceMutable": false,
      "lowLiquidity": "false",
      "burnRate": "2.50",
      "isMintable": false,
      "modifyableTax": false,
      "selfDestruct": false,
      "liquidityBurnPercentage": 75.5,
      "noMintAuthority": true
    },
    "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
  • currencies (optional) — Comma-separated list of fiat currencies for price conversion. Defaults to USD

​
Usage Examples

# Batch query with default USD
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"
    }
  ]'

# Batch query with multi-currency
curl -X POST "https://api.mobula.io/api/2/token/details" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "blockchain": "evm:1",
      "address": "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599",
      "currencies": "EUR,USD,GBP"
    },
    {
      "blockchain": "solana",
      "address": "3vz82EWYv8xnc7Cm7qSgERcpMeqw92PcX8PBz88npump",
      "currencies": "EUR,USD"
    }
  ]'

​
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,
      ...
    }
  ]
}

​
Multi-Currency Support

When you specify multiple currencies using the currencies parameter, the response will include additional fields for each currency. For every field ending in USD, a corresponding field will be added for each requested currency.

​
Example with currencies=EUR,USD

{
  "data": {
    "priceUSD": 0.0234,
    "priceEUR": 0.0215,
    "marketCapUSD": 18720000,
    "marketCapEUR": 17181600,
    "volume24hUSD": 890000.50,
    "volume24hEUR": 816810.46,
    "liquidityUSD": 250000.75,
    "liquidityEUR": 229500.69,
    // ... all other USD fields get their corresponding currency versions
  }
}

​
Converted Fields

The following field patterns are automatically converted:
  • priceUSD → price{CURRENCY}
  • marketCapUSD, marketCapDilutedUSD → marketCap{CURRENCY}, marketCapDiluted{CURRENCY}
  • volume*USD (all timeframes) → volume*{CURRENCY}
  • volumeBuy*USD, volumeSell*USD → volumeBuy*{CURRENCY}, volumeSell*{CURRENCY}
  • liquidityUSD, liquidityMaxUSD → liquidity{CURRENCY}, liquidityMax{CURRENCY}
  • approximateReserveUSD → approximateReserve{CURRENCY}
  • athUSD, atlUSD → ath{CURRENCY}, atl{CURRENCY}
  • feesPaid*USD, totalFeesPaidUSD → feesPaid*{CURRENCY}, totalFeesPaid{CURRENCY}
  • organicVolume*USD → organicVolume*{CURRENCY}
Exchange rates are fetched from reliable forex data providers and cached for optimal performance. Rates are updated every 30 minutes.

​
Response Field Definitions

​
Security Object

All fields in the security object are optional — they are only present when the relevant data is available for the token. A field being absent means the check was not performed or no data is available (not that the token is safe).
EVM vs Solana availability: Most fields apply to EVM chains. noMintAuthority is Solana-specific. isHoneypot, isNotOpenSource, renounced, locked, isWhitelisted, isMintable, modifyableTax, and selfDestruct are EVM-only.
FieldTypeDescription
buyTaxstringBuy fee as a percentage string (e.g. "5.00" = 5%). Present when a transfer tax is charged on buys.
sellTaxstringSell fee as a percentage string (e.g. "10.00" = 10%). Present when a transfer tax is charged on sells.
transferPausablebooleanWhether the contract owner can pause all token transfers.
top10HoldersstringPercentage of total supply held by the top 10 wallets (e.g. "42.50").
isBlacklistedbooleanWhether the contract contains a blacklist mechanism that can block specific addresses from trading.
isHoneypotbooleanWhether the token is a honeypot — users can buy but cannot sell. (EVM only)
isNotOpenSourcebooleanWhether the contract source code is not verified/open source on-chain. (EVM only)
renouncedbooleanWhether contract ownership has been renounced (owner is the zero address). (EVM only)
lockedstringPercentage of liquidity that is locked (e.g. "80.00"). (EVM only)
isWhitelistedbooleanWhether the contract has a whitelist mechanism restricting who can trade. (EVM only)
balanceMutablebooleanWhether the contract owner can arbitrarily modify token balances.
lowLiquiditystringIndicates low liquidity status (e.g. "true" or "false").
burnRatestringPercentage of each transaction automatically burned (e.g. "2.50").
isMintablebooleanWhether the contract allows minting new tokens after deployment. (EVM only)
modifyableTaxbooleanWhether the contract owner can change the buy/sell tax rates. (EVM only)
selfDestructbooleanWhether the contract contains a self-destruct function. (EVM only)
liquidityBurnPercentagenumberPercentage of liquidity pool tokens that have been burned (legacy — prefer the top-level liquidityBurnPercentage field below).
noMintAuthoritybooleanWhether the mint authority has been disabled (safe = true). (Solana only)

​
PumpFun Flags

These fields are specific to tokens launched on PumpFun (Solana). They are null for non-PumpFun tokens.
FieldTypeDescription
isMayhemModeboolean | nullWhether the token was created with Mayhem Mode enabled. When true, an AI trading agent trades the coin for 24h after creation. Immutable once set. (Solana PumpFun only)
isCashbackCoinboolean | nullWhether the token was created with Trader Cashback enabled. When true, 100% of creator fees are redistributed to traders. Immutable once set. (Solana PumpFun only)

​
Liquidity Burn

FieldTypeDescription
liquidityBurnPercentagenumber | nullShare of LP tokens (V2 pools) or position liquidity (V3/V4) held by dead/locker addresses for the largest pool. Computed from on-chain LP holder balances — no longer sourced from GoPlus. null while the cache is cold (warms on first token/security call for this token). Range 0–100.

​
Holdings Data

The response includes various holdings percentage fields that help identify token distribution patterns:
  • top10HoldingsPercentage, top50HoldingsPercentage, top100HoldingsPercentage, top200HoldingsPercentage — Percentage of total supply held by the top N holders
  • devHoldingsPercentage — Percentage held by the token deployer/developer
  • insidersHoldingsPercentage — Percentage held by wallets identified as insiders (early participants with privileged access)
  • bundlersHoldingsPercentage — Percentage held by wallets using bundling strategies (multiple transactions in a single block)
  • snipersHoldingsPercentage — Percentage held by wallets that sniped the token at launch
  • proTradersHoldingsPercentage — Percentage held by accounts that interact with trading terminals (e.g., BullX, Photon, GMGN, Trojan, and other trading bots/interfaces). These wallets are identified by their interaction patterns with known trading terminal contracts and interfaces.
  • freshTradersHoldingsPercentage — Percentage held by newly funded wallets (within last 24 hours)
  • insidersCount, bundlersCount, snipersCount, freshTradersCount, proTradersCount — Number of holders in each category

​
Fees Paid Data

The feesPaid* fields represent an aggregation of transaction costs across all trades for this token:
  • feesPaid1minUSD, feesPaid5minUSD, feesPaid15minUSD, feesPaid1hUSD, etc. — Total fees paid over the specified timeframe
  • totalFeesPaidUSD — Cumulative fees paid since token creation
What’s included:
  • Priority fees (Solana) / Gas fees (EVM chains)
  • UI fees charged by trading terminals and interfaces
  • Protocol fees from DEX platforms
These values are approximate estimates based on heuristics. The calculation does not account for cashback systems, fee rebates, or certain terminal-specific fee structures. Use these values as directional indicators rather than precise figures.

​
Organic Metrics

The organic* fields filter out wash trading and bot activity to provide cleaner trading metrics:
  • organicTrades* — Trade count excluding suspected bot/wash activity
  • organicTraders* — Unique trader count excluding suspected bots
  • organicVolume* — Volume excluding suspected artificial activity
  • organicBuys*, organicSells* — Buy/sell counts excluding bots
  • organicBuyers*, organicSellers* — Unique buyer/seller counts excluding bots

​
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

​
chainId
string

Blockchain chain ID (e.g., "evm:56", "solana:solana")

​
address
string

Token contract address

​
currencies
string

Comma-separated list of currencies for price conversion

Response

200 - application/json

Token Holder response

​
data
object
required
​
hostname
string