> ## 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.
# Get Token Details
> Retrieve detailed token information including metadata, supply, market cap, volume statistics, holdings data, and trading activity over multiple timeframes.
**Batch Support Available**: This endpoint supports batch queries via POST method for fetching multiple tokens in a single request. [Jump to Batch Query section](#post-method-batch-query)
## 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](https://docs.mobula.io/guides/how-to-get-in-depth-token-details)
### Usage Examples
```bash theme={null}
# 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¤cies=EUR,USD"
```
### Response Format
```json theme={null}
{
"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,
"isOGCoin": 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,
"dexScreenerEnhanced": {
"enhanced": true,
"icon": "https://cdn.dexscreener.com/cms/images/e6851bfbd8e096ac5e44e8b71f2a34c949e2c777ec5523c0c6a06459b1299aad?width=64&height=64&quality=90&format=webp",
"header": "https://cdn.dexscreener.com/cms/images/41394d85f86d5d3181e7f322983752270d97277c72bdf14655c57afbc2934f2b?width=600&height=200&quality=90&format=webp",
"description": "2025 : Year Of Alien Invasion",
"links": [
{ "url": "https://invasiononsol.xyz/", "label": "Website" },
{ "url": "https://x.com/invasionon_sol", "type": "twitter" },
{ "url": "https://t.me/invasionportal", "type": "telegram" }
],
"isCto": true,
"timestamp": 1735521401000,
"previousEnhancements": [
{
"icon": "https://cdn.dexscreener.com/cms/images/e6851bfbd8e096ac5e44e8b71f2a34c949e2c777ec5523c0c6a06459b1299aad",
"header": null,
"description": "COMMUNITY TAKEOVER",
"links": [
{ "url": "https://x.com/invasioncto", "type": "twitter" },
{ "url": "https://t.me/InvasionCTOPortal", "type": "telegram" }
],
"isCto": true,
"timestamp": 1735513478553
}
]
}
}
}
```
## POST Method - Batch Query
Retrieve token details for multiple tokens in a single request for improved efficiency.
### Request Body
```json theme={null}
[
{
"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
```bash theme={null}
# 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
```json theme={null}
{
"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`
```json theme={null}
{
"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.
| 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 are `null` 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 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
## OpenAPI
````yaml get /2/token/details
openapi: 3.0.0
info:
version: 1.0.0
title: Mobula API
description: >-
Documentation of the Mobula API
**Demo API**: The default server (demo-api.mobula.io) is a demo API with
rate limits.
For production use, please use api.mobula.io with an API key from
https://admin.mobula.io
servers:
- url: https://demo-api.mobula.io/api/
description: Demo API (rate limited, for testing only)
- url: https://api.mobula.io/api/
description: Production API (requires API key)
security: []
tags:
- name: V2 - Token
description: Token details, price, security, ATH, and holder data
- name: V2 - Market Data
description: Market details, OHLCV history, and lighthouse metrics
- name: V2 - Trades
description: Token trades, enriched trades, and trade filters
- name: V2 - Wallet
description: Wallet positions, activity, trades, analysis, and labels
- name: V2 - Assets
description: Cross-chain asset details and price history
- name: V2 - Swap
description: Swap quoting and execution
- name: V2 - Perps
description: Perpetual futures quoting, execution, and positions
- name: V2 - Bridge
description: Cross-chain bridge quoting and intent status (Alpha Preview)
- name: V2 - DeFi
description: Bonding pools and pulse data
- name: V2 - Search
description: Universal fast search
- name: V2 - Blockchains
description: System metadata and chain listings
- name: V1 - Market Data
description: Market prices, history, sparklines, pairs, and multi-data
- name: V1 - Wallet
description: Wallet portfolio, transactions, history, and NFTs
- name: V1 - Token
description: First buyers
- name: V1 - Trades
description: Market trades by pair
- name: V1 - Metadata
description: Token metadata, categories, trendings, and news
- name: V1 - Assets
description: List all assets
- name: V1 - Search
description: Search for assets, tokens, and pairs
- name: V1 - DeFi
description: Bonding pool pulse data
- name: V1 - Blockchains
description: Blockchain listings, pairs, and stats
- name: V1 - Webhooks
description: Webhook management
- name: V1 - Feed
description: Custom feed creation
paths:
/2/token/details:
get:
tags:
- V2 - Token
summary: Get Comprehensive Token Details
parameters:
- schema:
type: string
description: Blockchain chain ID (e.g., "evm:56", "solana:solana")
required: false
description: Blockchain chain ID (e.g., "evm:56", "solana:solana")
name: chainId
in: query
- schema:
type: string
description: Token contract address
required: false
description: Token contract address
name: address
in: query
- schema:
type: string
description: Comma-separated list of currencies for price conversion
required: false
description: Comma-separated list of currencies for price conversion
name: currencies
in: query
responses:
'200':
description: Token Holder response
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
address:
type: string
chainId:
type: string
symbol:
type: string
nullable: true
name:
type: string
nullable: true
decimals:
type: number
nullable: true
default: 0
id:
type: number
nullable: true
default: null
priceUSD:
type: number
nullable: true
default: 0
priceToken:
type: number
nullable: true
default: 0
priceTokenString:
type: string
approximateReserveUSD:
type: number
nullable: true
default: 0
approximateReserveTokenRaw:
type: string
approximateReserveToken:
type: number
nullable: true
default: 0
totalSupply:
type: number
nullable: true
default: 0
circulatingSupply:
type: number
nullable: true
default: 0
marketCapUSD:
type: number
nullable: true
default: 0
marketCapDilutedUSD:
type: number
nullable: true
default: 0
logo:
type: string
nullable: true
originLogoUrl:
type: string
nullable: true
rank:
type: number
nullable: true
default: null
cexs:
type: array
items:
type: string
default: []
exchange:
type: object
properties:
name:
type: string
logo:
type: string
required:
- name
- logo
factory:
type: string
nullable: true
source:
type: string
nullable: true
sourceFactory:
type: string
nullable: true
sourceMetadata:
type: object
nullable: true
properties:
name:
type: string
logo:
type: string
required:
- name
- logo
sourceFactoryMetadata:
type: object
nullable: true
properties:
name:
type: string
logo:
type: string
required:
- name
- logo
liquidityUSD:
type: number
nullable: true
liquidityMaxUSD:
type: number
nullable: true
bonded:
type: boolean
bondingPercentage:
type: number
nullable: true
bondingCurveAddress:
type: string
nullable: true
preBondingFactory:
type: string
poolAddress:
type: string
blockchain:
type: string
type:
type: string
tokenType:
type: string
nullable: true
enum:
- '2020'
- '2022'
deployer:
type: string
nullable: true
bondedAt:
type: string
nullable: true
athUSD:
type: number
nullable: true
atlUSD:
type: number
nullable: true
athDate:
type: string
nullable: true
atlDate:
type: string
nullable: true
priceChange1minPercentage:
type: number
nullable: true
default: 0
priceChange5minPercentage:
type: number
nullable: true
default: 0
priceChange1hPercentage:
type: number
nullable: true
default: 0
priceChange4hPercentage:
type: number
nullable: true
default: 0
priceChange6hPercentage:
type: number
nullable: true
default: 0
priceChange12hPercentage:
type: number
nullable: true
default: 0
priceChange24hPercentage:
type: number
nullable: true
default: 0
poolPriceChange1minPercentage:
type: number
nullable: true
default: 0
poolPriceChange5minPercentage:
type: number
nullable: true
default: 0
poolPriceChange1hPercentage:
type: number
nullable: true
default: 0
poolPriceChange4hPercentage:
type: number
nullable: true
default: 0
poolPriceChange6hPercentage:
type: number
nullable: true
default: 0
poolPriceChange12hPercentage:
type: number
nullable: true
default: 0
poolPriceChange24hPercentage:
type: number
nullable: true
default: 0
liquidityBurnPercentage:
type: number
nullable: true
volume1minUSD:
type: number
nullable: true
default: 0
volume5minUSD:
type: number
nullable: true
default: 0
volume15minUSD:
type: number
nullable: true
default: 0
volume1hUSD:
type: number
nullable: true
default: 0
volume4hUSD:
type: number
nullable: true
default: 0
volume6hUSD:
type: number
nullable: true
default: 0
volume12hUSD:
type: number
nullable: true
default: 0
volume24hUSD:
type: number
nullable: true
default: 0
volumeBuy1minUSD:
type: number
nullable: true
default: 0
volumeBuy5minUSD:
type: number
nullable: true
default: 0
volumeBuy15minUSD:
type: number
nullable: true
default: 0
volumeBuy1hUSD:
type: number
nullable: true
default: 0
volumeBuy4hUSD:
type: number
nullable: true
default: 0
volumeBuy6hUSD:
type: number
nullable: true
default: 0
volumeBuy12hUSD:
type: number
nullable: true
default: 0
volumeBuy24hUSD:
type: number
nullable: true
default: 0
volumeSell1minUSD:
type: number
nullable: true
default: 0
volumeSell5minUSD:
type: number
nullable: true
default: 0
volumeSell15minUSD:
type: number
nullable: true
default: 0
volumeSell1hUSD:
type: number
nullable: true
default: 0
volumeSell4hUSD:
type: number
nullable: true
default: 0
volumeSell6hUSD:
type: number
nullable: true
default: 0
volumeSell12hUSD:
type: number
nullable: true
default: 0
volumeSell24hUSD:
type: number
nullable: true
default: 0
trades1min:
type: number
nullable: true
default: 0
trades5min:
type: number
nullable: true
default: 0
trades15min:
type: number
nullable: true
default: 0
trades1h:
type: number
nullable: true
default: 0
trades4h:
type: number
nullable: true
default: 0
trades6h:
type: number
nullable: true
default: 0
trades12h:
type: number
nullable: true
default: 0
trades24h:
type: number
nullable: true
default: 0
buys1min:
type: number
nullable: true
default: 0
buys5min:
type: number
nullable: true
default: 0
buys15min:
type: number
nullable: true
default: 0
buys1h:
type: number
nullable: true
default: 0
buys4h:
type: number
nullable: true
default: 0
buys6h:
type: number
nullable: true
default: 0
buys12h:
type: number
nullable: true
default: 0
buys24h:
type: number
nullable: true
default: 0
sells1min:
type: number
nullable: true
default: 0
sells5min:
type: number
nullable: true
default: 0
sells15min:
type: number
nullable: true
default: 0
sells1h:
type: number
nullable: true
default: 0
sells4h:
type: number
nullable: true
default: 0
sells6h:
type: number
nullable: true
default: 0
sells12h:
type: number
nullable: true
default: 0
sells24h:
type: number
nullable: true
default: 0
buyers1min:
type: number
nullable: true
default: 0
buyers5min:
type: number
nullable: true
default: 0
buyers15min:
type: number
nullable: true
default: 0
buyers1h:
type: number
nullable: true
default: 0
buyers4h:
type: number
nullable: true
default: 0
buyers6h:
type: number
nullable: true
default: 0
buyers12h:
type: number
nullable: true
default: 0
buyers24h:
type: number
nullable: true
default: 0
sellers1min:
type: number
nullable: true
default: 0
sellers5min:
type: number
nullable: true
default: 0
sellers15min:
type: number
nullable: true
default: 0
sellers1h:
type: number
nullable: true
default: 0
sellers4h:
type: number
nullable: true
default: 0
sellers6h:
type: number
nullable: true
default: 0
sellers12h:
type: number
nullable: true
default: 0
sellers24h:
type: number
nullable: true
default: 0
traders1min:
type: number
nullable: true
default: 0
traders5min:
type: number
nullable: true
default: 0
traders15min:
type: number
nullable: true
default: 0
traders1h:
type: number
nullable: true
default: 0
traders4h:
type: number
nullable: true
default: 0
traders6h:
type: number
nullable: true
default: 0
traders12h:
type: number
nullable: true
default: 0
traders24h:
type: number
nullable: true
default: 0
feesPaid1minUSD:
type: number
nullable: true
default: 0
feesPaid5minUSD:
type: number
nullable: true
default: 0
feesPaid15minUSD:
type: number
nullable: true
default: 0
feesPaid1hUSD:
type: number
nullable: true
default: 0
feesPaid4hUSD:
type: number
nullable: true
default: 0
feesPaid6hUSD:
type: number
nullable: true
default: 0
feesPaid12hUSD:
type: number
nullable: true
default: 0
feesPaid24hUSD:
type: number
nullable: true
default: 0
totalFeesPaidUSD:
type: number
nullable: true
default: 0
totalFeesPaidNativeRaw:
type: string
nullable: true
default: '0'
organicTrades1min:
type: number
nullable: true
default: 0
organicTrades5min:
type: number
nullable: true
default: 0
organicTrades15min:
type: number
nullable: true
default: 0
organicTrades1h:
type: number
nullable: true
default: 0
organicTrades4h:
type: number
nullable: true
default: 0
organicTrades6h:
type: number
nullable: true
default: 0
organicTrades12h:
type: number
nullable: true
default: 0
organicTrades24h:
type: number
nullable: true
default: 0
organicTraders1min:
type: number
nullable: true
default: 0
organicTraders5min:
type: number
nullable: true
default: 0
organicTraders15min:
type: number
nullable: true
default: 0
organicTraders1h:
type: number
nullable: true
default: 0
organicTraders4h:
type: number
nullable: true
default: 0
organicTraders6h:
type: number
nullable: true
default: 0
organicTraders12h:
type: number
nullable: true
default: 0
organicTraders24h:
type: number
nullable: true
default: 0
organicVolume1minUSD:
type: number
nullable: true
default: 0
organicVolume5minUSD:
type: number
nullable: true
default: 0
organicVolume15minUSD:
type: number
nullable: true
default: 0
organicVolume1hUSD:
type: number
nullable: true
default: 0
organicVolume4hUSD:
type: number
nullable: true
default: 0
organicVolume6hUSD:
type: number
nullable: true
default: 0
organicVolume12hUSD:
type: number
nullable: true
default: 0
organicVolume24hUSD:
type: number
nullable: true
default: 0
organicVolumeBuy1minUSD:
type: number
nullable: true
default: 0
organicVolumeBuy5minUSD:
type: number
nullable: true
default: 0
organicVolumeBuy15minUSD:
type: number
nullable: true
default: 0
organicVolumeBuy1hUSD:
type: number
nullable: true
default: 0
organicVolumeBuy4hUSD:
type: number
nullable: true
default: 0
organicVolumeBuy6hUSD:
type: number
nullable: true
default: 0
organicVolumeBuy12hUSD:
type: number
nullable: true
default: 0
organicVolumeBuy24hUSD:
type: number
nullable: true
default: 0
organicVolumeSell1minUSD:
type: number
nullable: true
default: 0
organicVolumeSell5minUSD:
type: number
nullable: true
default: 0
organicVolumeSell15minUSD:
type: number
nullable: true
default: 0
organicVolumeSell1hUSD:
type: number
nullable: true
default: 0
organicVolumeSell4hUSD:
type: number
nullable: true
default: 0
organicVolumeSell6hUSD:
type: number
nullable: true
default: 0
organicVolumeSell12hUSD:
type: number
nullable: true
default: 0
organicVolumeSell24hUSD:
type: number
nullable: true
default: 0
organicBuys1min:
type: number
nullable: true
default: 0
organicBuys5min:
type: number
nullable: true
default: 0
organicBuys15min:
type: number
nullable: true
default: 0
organicBuys1h:
type: number
nullable: true
default: 0
organicBuys4h:
type: number
nullable: true
default: 0
organicBuys6h:
type: number
nullable: true
default: 0
organicBuys12h:
type: number
nullable: true
default: 0
organicBuys24h:
type: number
nullable: true
default: 0
organicSells1min:
type: number
nullable: true
default: 0
organicSells5min:
type: number
nullable: true
default: 0
organicSells15min:
type: number
nullable: true
default: 0
organicSells1h:
type: number
nullable: true
default: 0
organicSells4h:
type: number
nullable: true
default: 0
organicSells6h:
type: number
nullable: true
default: 0
organicSells12h:
type: number
nullable: true
default: 0
organicSells24h:
type: number
nullable: true
default: 0
organicBuyers1min:
type: number
nullable: true
default: 0
organicBuyers5min:
type: number
nullable: true
default: 0
organicBuyers15min:
type: number
nullable: true
default: 0
organicBuyers1h:
type: number
nullable: true
default: 0
organicBuyers4h:
type: number
nullable: true
default: 0
organicBuyers6h:
type: number
nullable: true
default: 0
organicBuyers12h:
type: number
nullable: true
default: 0
organicBuyers24h:
type: number
nullable: true
default: 0
organicSellers1min:
type: number
nullable: true
default: 0
organicSellers5min:
type: number
nullable: true
default: 0
organicSellers15min:
type: number
nullable: true
default: 0
organicSellers1h:
type: number
nullable: true
default: 0
organicSellers4h:
type: number
nullable: true
default: 0
organicSellers6h:
type: number
nullable: true
default: 0
organicSellers12h:
type: number
nullable: true
default: 0
organicSellers24h:
type: number
nullable: true
default: 0
createdAt:
type: string
nullable: true
latestTradeDate:
type: string
nullable: true
holdersCount:
type: number
nullable: true
description:
type: string
nullable: true
socials:
type: object
properties:
twitter:
type: string
nullable: true
website:
type: string
nullable: true
telegram:
type: string
nullable: true
others:
type: object
nullable: true
additionalProperties:
nullable: true
uri:
type: string
required:
- twitter
- website
- telegram
- others
security:
type: object
nullable: true
properties:
buyTax:
type: string
nullable: true
sellTax:
type: string
nullable: true
transferPausable:
type: boolean
top10Holders:
type: string
isBlacklisted:
type: boolean
noMintAuthority:
type: boolean
balanceMutable:
type: boolean
lowLiquidity:
type: string
burnRate:
type: string
liquidityBurnPercentage:
type: number
isHoneypot:
type: boolean
isNotOpenSource:
type: boolean
renounced:
type: boolean
locked:
type: string
isWhitelisted:
type: boolean
isMintable:
type: boolean
modifyableTax:
type: boolean
selfDestruct:
type: boolean
twitterReusesCount:
type: number
nullable: true
default: 0
twitterRenameCount:
type: number
nullable: true
default: 0
twitterRenameHistory:
type: array
items:
type: object
properties:
username:
type: string
lastChecked:
type: string
required:
- username
- lastChecked
default: []
deployerMigrationsCount:
type: number
nullable: true
default: 0
deployerTokensCount:
type: number
nullable: true
default: 0
dexscreenerListed:
type: boolean
nullable: true
default: false
dexscreenerHeader:
type: string
nullable: true
default: null
dexscreenerAdPaid:
type: boolean
nullable: true
default: false
dexscreenerAdPaidDate:
type: string
nullable: true
default: null
dexScreenerEnhanced:
type: object
nullable: true
properties:
icon:
type: string
nullable: true
header:
type: string
nullable: true
description:
type: string
nullable: true
links:
type: array
items:
type: object
properties:
url:
type: string
label:
type: string
type:
type: string
required:
- url
default: []
isCto:
type: boolean
default: false
timestamp:
type: number
nullable: true
enhanced:
type: boolean
default: false
previousEnhancements:
type: array
items:
type: object
properties:
icon:
type: string
nullable: true
header:
type: string
nullable: true
description:
type: string
nullable: true
links:
type: array
items:
type: object
properties:
url:
type: string
label:
type: string
type:
type: string
required:
- url
default: []
isCto:
type: boolean
default: false
timestamp:
type: number
nullable: true
required:
- icon
- header
- description
- timestamp
default: []
default: null
required:
- icon
- header
- description
- timestamp
dexscreenerPendingAt:
type: string
nullable: true
default: null
dexscreenerSocialPaid:
type: boolean
nullable: true
default: false
dexscreenerSocialPaidDate:
type: string
nullable: true
default: null
liveStatus:
type: string
nullable: true
liveThumbnail:
type: string
nullable: true
livestreamTitle:
type: string
nullable: true
liveReplyCount:
type: number
nullable: true
dexscreenerBoosted:
type: boolean
nullable: true
default: false
dexscreenerBoostedDate:
type: string
nullable: true
default: null
dexscreenerBoostedAmount:
type: number
nullable: true
default: 0
trendingScore1min:
type: number
nullable: true
default: 0
trendingScore5min:
type: number
nullable: true
default: 0
trendingScore15min:
type: number
nullable: true
default: 0
trendingScore1h:
type: number
nullable: true
default: 0
trendingScore4h:
type: number
nullable: true
default: 0
trendingScore6h:
type: number
nullable: true
default: 0
trendingScore12h:
type: number
nullable: true
default: 0
trendingScore24h:
type: number
nullable: true
default: 0
isMayhemMode:
type: boolean
nullable: true
default: null
isCashbackCoin:
type: boolean
nullable: true
default: null
isAgentMode:
type: boolean
nullable: true
default: null
isOGCoin:
type: boolean
nullable: true
default: null
top10HoldingsPercentage:
type: number
nullable: true
top50HoldingsPercentage:
type: number
nullable: true
top100HoldingsPercentage:
type: number
nullable: true
top200HoldingsPercentage:
type: number
nullable: true
devHoldingsPercentage:
type: number
nullable: true
insidersHoldingsPercentage:
type: number
nullable: true
bundlersHoldingsPercentage:
type: number
nullable: true
snipersHoldingsPercentage:
type: number
nullable: true
proTradersHoldingsPercentage:
type: number
nullable: true
freshTradersHoldingsPercentage:
type: number
nullable: true
smartTradersHoldingsPercentage:
type: number
nullable: true
insidersCount:
type: number
nullable: true
bundlersCount:
type: number
nullable: true
snipersCount:
type: number
nullable: true
freshTradersCount:
type: number
nullable: true
proTradersCount:
type: number
nullable: true
smartTradersCount:
type: number
nullable: true
freshTradersBuys:
type: number
nullable: true
proTradersBuys:
type: number
nullable: true
smartTradersBuys:
type: number
nullable: true
required:
- address
- chainId
- symbol
- name
- priceTokenString
- approximateReserveTokenRaw
- logo
- bondedAt
- createdAt
- latestTradeDate
- description
- socials
- security
- liveStatus
- liveThumbnail
- livestreamTitle
- liveReplyCount
hostname:
type: string
required:
- data
````