Get Comprehensive Token Details
Market & Token Data
Get Token Details
Retrieve detailed token information including metadata, supply, market cap, volume statistics, holdings data, and trading activity over multiple timeframes.
GET
Get Comprehensive Token Details
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 addresscurrencies(optional) — Comma-separated list of fiat currencies for price conversion. Defaults toUSD. 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
Response Format
POST Method - Batch Query
Retrieve token details for multiple tokens in a single request for improved efficiency.Request Body
Body Parameters
The request body is an array of query objects, where each object contains:blockchain(required) — Blockchain id or nameaddress(required) — Direct token addresscurrencies(optional) — Comma-separated list of fiat currencies for price conversion. Defaults toUSD
Usage Examples
Response Format
Multi-Currency Support
When you specify multiple currencies using thecurrencies 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
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 thesecurity 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.| Field | Type | Description |
|---|---|---|
buyTax | string | Buy fee as a percentage string (e.g. "5.00" = 5%). Present when a transfer tax is charged on buys. |
sellTax | string | Sell fee as a percentage string (e.g. "10.00" = 10%). Present when a transfer tax is charged on sells. |
transferPausable | boolean | Whether the contract owner can pause all token transfers. |
top10Holders | string | Percentage of total supply held by the top 10 wallets (e.g. "42.50"). |
isBlacklisted | boolean | Whether the contract contains a blacklist mechanism that can block specific addresses from trading. |
isHoneypot | boolean | Whether the token is a honeypot — users can buy but cannot sell. (EVM only) |
isNotOpenSource | boolean | Whether the contract source code is not verified/open source on-chain. (EVM only) |
renounced | boolean | Whether contract ownership has been renounced (owner is the zero address). (EVM only) |
locked | string | Percentage of liquidity that is locked (e.g. "80.00"). (EVM only) |
isWhitelisted | boolean | Whether the contract has a whitelist mechanism restricting who can trade. (EVM only) |
balanceMutable | boolean | Whether the contract owner can arbitrarily modify token balances. |
lowLiquidity | string | Indicates low liquidity status (e.g. "true" or "false"). |
burnRate | string | Percentage of each transaction automatically burned (e.g. "2.50"). |
isMintable | boolean | Whether the contract allows minting new tokens after deployment. (EVM only) |
modifyableTax | boolean | Whether the contract owner can change the buy/sell tax rates. (EVM only) |
selfDestruct | boolean | Whether the contract contains a self-destruct function. (EVM only) |
liquidityBurnPercentage | number | Percentage of liquidity pool tokens that have been burned (legacy — prefer the top-level liquidityBurnPercentage field below). |
noMintAuthority | boolean | Whether the mint authority has been disabled (safe = true). (Solana only) |
PumpFun Flags
These fields are specific to tokens launched on PumpFun (Solana). They arenull for non-PumpFun tokens.
| Field | Type | Description |
|---|---|---|
isMayhemMode | boolean | null | Whether 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) |
isCashbackCoin | boolean | null | Whether the token was created with Trader Cashback enabled. When true, 100% of creator fees are redistributed to traders. Immutable once set. (Solana PumpFun only) |
OG Coin
| Field | Type | Description |
|---|---|---|
isOGCoin | boolean | null | true when no other token on the same chain shares this token’s name — i.e. this is the “original” coin for that name. false when at least one prior token with the same (chainId, name) already exists (the new one is a copycat / rename). null while the flag is still being resolved (resolution is async and runs once per token after creation, plus a lazy retry on the first swap). Cross-chain: only same-chain siblings are considered, so the same name can be OG on multiple chains. |
Liquidity Burn
| Field | Type | Description |
|---|---|---|
liquidityBurnPercentage | number | null | Share 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 holdersdevHoldingsPercentage— Percentage held by the token deployer/developerinsidersHoldingsPercentage— 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 launchproTradersHoldingsPercentage— 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
ThefeesPaid* fields represent an aggregation of transaction costs across all trades for this token:
feesPaid1minUSD,feesPaid5minUSD,feesPaid15minUSD,feesPaid1hUSD, etc. — Total fees paid over the specified timeframetotalFeesPaidUSD— Cumulative fees paid since token creation
- Priority fees (Solana) / Gas fees (EVM chains)
- UI fees charged by trading terminals and interfaces
- Protocol fees from DEX platforms
Organic Metrics
Theorganic* fields filter out wash trading and bot activity to provide cleaner trading metrics:
organicTrades*— Trade count excluding suspected bot/wash activityorganicTraders*— Unique trader count excluding suspected botsorganicVolume*— Volume excluding suspected artificial activityorganicBuys*,organicSells*— Buy/sell counts excluding botsorganicBuyers*,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