---
title: "Retrieve Comprehensive Token Details"
method: POST
path: "/api/2/token/details"
tags: ["V2 - Token"]
---

# Retrieve Comprehensive Token Details

`POST /api/2/token/details`

Batch variant: fetch full token details for multiple tokens. Send an array of {address, blockchain} objects. Same comprehensive response per token.

## Request body

- union
  - object[]
    - `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
  - object
    - `items` object[], required
      - `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`

Token Holder response

- object
  - `payload` union[], required
    - union
      - object
        - `address` string, required
        - `chainId` string, required
        - `symbol` string, nullable, required
        - `name` string, nullable, required
        - `decimals` number, nullable
        - `id` number, nullable
        - `priceUSD` number, nullable
        - `priceToken` number, nullable
        - `priceTokenString` string, required
        - `approximateReserveUSD` number, nullable
        - `approximateReserveTokenRaw` string, required
        - `approximateReserveToken` number, nullable
        - `totalSupply` number, nullable
        - `circulatingSupply` number, nullable
        - `marketCapUSD` number, nullable
        - `marketCapDilutedUSD` number, nullable
        - `logo` string, nullable, required
        - `originLogoUrl` string, nullable
        - `rank` number, nullable
        - `cexs` string[]
        - `exchange` object
          - `name` string, required
          - `logo` string, required
        - `factory` string, nullable
        - `source` string, nullable
        - `sourceFactory` string, nullable
        - `sourceMetadata` object, nullable
          - `name` string, required
          - `logo` string, required
        - `sourceFactoryMetadata` object, nullable
          - `name` string, required
          - `logo` string, required
        - `liquidityUSD` number, nullable
        - `liquidityMaxUSD` number, nullable
        - `bonded` boolean
        - `bondingPercentage` number, nullable
        - `bondingCurveAddress` string, nullable
        - `preBondingFactory` string
        - `poolAddress` string
        - `blockchain` string
        - `type` string
        - `tokenType` '2020' | '2022', nullable
        - `deployer` string, nullable
        - `bondedAt` string, nullable, required
        - `athUSD` number, nullable
        - `atlUSD` number, nullable
        - `athDate` string, nullable
        - `atlDate` string, nullable
        - `priceChange1minPercentage` number, nullable
        - `priceChange5minPercentage` number, nullable
        - `priceChange1hPercentage` number, nullable
        - `priceChange4hPercentage` number, nullable
        - `priceChange6hPercentage` number, nullable
        - `priceChange12hPercentage` number, nullable
        - `priceChange24hPercentage` number, nullable
        - `poolPriceChange1minPercentage` number, nullable
        - `poolPriceChange5minPercentage` number, nullable
        - `poolPriceChange1hPercentage` number, nullable
        - `poolPriceChange4hPercentage` number, nullable
        - `poolPriceChange6hPercentage` number, nullable
        - `poolPriceChange12hPercentage` number, nullable
        - `poolPriceChange24hPercentage` number, nullable
        - `liquidityBurnPercentage` number, nullable
        - `volume1minUSD` number, nullable
        - `volume5minUSD` number, nullable
        - `volume15minUSD` number, nullable
        - `volume1hUSD` number, nullable
        - `volume4hUSD` number, nullable
        - `volume6hUSD` number, nullable
        - `volume12hUSD` number, nullable
        - `volume24hUSD` number, nullable
        - `volumeBuy1minUSD` number, nullable
        - `volumeBuy5minUSD` number, nullable
        - `volumeBuy15minUSD` number, nullable
        - `volumeBuy1hUSD` number, nullable
        - `volumeBuy4hUSD` number, nullable
        - `volumeBuy6hUSD` number, nullable
        - `volumeBuy12hUSD` number, nullable
        - `volumeBuy24hUSD` number, nullable
        - `volumeSell1minUSD` number, nullable
        - `volumeSell5minUSD` number, nullable
        - `volumeSell15minUSD` number, nullable
        - `volumeSell1hUSD` number, nullable
        - `volumeSell4hUSD` number, nullable
        - `volumeSell6hUSD` number, nullable
        - `volumeSell12hUSD` number, nullable
        - `volumeSell24hUSD` number, nullable
        - `trades1min` number, nullable
        - `trades5min` number, nullable
        - `trades15min` number, nullable
        - `trades1h` number, nullable
        - `trades4h` number, nullable
        - `trades6h` number, nullable
        - `trades12h` number, nullable
        - `trades24h` number, nullable
        - `buys1min` number, nullable
        - `buys5min` number, nullable
        - `buys15min` number, nullable
        - `buys1h` number, nullable
        - `buys4h` number, nullable
        - `buys6h` number, nullable
        - `buys12h` number, nullable
        - `buys24h` number, nullable
        - `sells1min` number, nullable
        - `sells5min` number, nullable
        - `sells15min` number, nullable
        - `sells1h` number, nullable
        - `sells4h` number, nullable
        - `sells6h` number, nullable
        - `sells12h` number, nullable
        - `sells24h` number, nullable
        - `buyers1min` number, nullable
        - `buyers5min` number, nullable
        - `buyers15min` number, nullable
        - `buyers1h` number, nullable
        - `buyers4h` number, nullable
        - `buyers6h` number, nullable
        - `buyers12h` number, nullable
        - `buyers24h` number, nullable
        - `sellers1min` number, nullable
        - `sellers5min` number, nullable
        - `sellers15min` number, nullable
        - `sellers1h` number, nullable
        - `sellers4h` number, nullable
        - `sellers6h` number, nullable
        - `sellers12h` number, nullable
        - `sellers24h` number, nullable
        - `traders1min` number, nullable
        - `traders5min` number, nullable
        - `traders15min` number, nullable
        - `traders1h` number, nullable
        - `traders4h` number, nullable
        - `traders6h` number, nullable
        - `traders12h` number, nullable
        - `traders24h` number, nullable
        - `feesPaid1minUSD` number, nullable
        - `feesPaid5minUSD` number, nullable
        - `feesPaid15minUSD` number, nullable
        - `feesPaid1hUSD` number, nullable
        - `feesPaid4hUSD` number, nullable
        - `feesPaid6hUSD` number, nullable
        - `feesPaid12hUSD` number, nullable
        - `feesPaid24hUSD` number, nullable
        - `totalFeesPaidUSD` number, nullable
        - `totalFeesPaidNativeRaw` string, nullable
        - `organicTrades1min` number, nullable
        - `organicTrades5min` number, nullable
        - `organicTrades15min` number, nullable
        - `organicTrades1h` number, nullable
        - `organicTrades4h` number, nullable
        - `organicTrades6h` number, nullable
        - `organicTrades12h` number, nullable
        - `organicTrades24h` number, nullable
        - `organicTraders1min` number, nullable
        - `organicTraders5min` number, nullable
        - `organicTraders15min` number, nullable
        - `organicTraders1h` number, nullable
        - `organicTraders4h` number, nullable
        - `organicTraders6h` number, nullable
        - `organicTraders12h` number, nullable
        - `organicTraders24h` number, nullable
        - `organicVolume1minUSD` number, nullable
        - `organicVolume5minUSD` number, nullable
        - `organicVolume15minUSD` number, nullable
        - `organicVolume1hUSD` number, nullable
        - `organicVolume4hUSD` number, nullable
        - `organicVolume6hUSD` number, nullable
        - `organicVolume12hUSD` number, nullable
        - `organicVolume24hUSD` number, nullable
        - `organicVolumeBuy1minUSD` number, nullable
        - `organicVolumeBuy5minUSD` number, nullable
        - `organicVolumeBuy15minUSD` number, nullable
        - `organicVolumeBuy1hUSD` number, nullable
        - `organicVolumeBuy4hUSD` number, nullable
        - `organicVolumeBuy6hUSD` number, nullable
        - `organicVolumeBuy12hUSD` number, nullable
        - `organicVolumeBuy24hUSD` number, nullable
        - `organicVolumeSell1minUSD` number, nullable
        - `organicVolumeSell5minUSD` number, nullable
        - `organicVolumeSell15minUSD` number, nullable
        - `organicVolumeSell1hUSD` number, nullable
        - `organicVolumeSell4hUSD` number, nullable
        - `organicVolumeSell6hUSD` number, nullable
        - `organicVolumeSell12hUSD` number, nullable
        - `organicVolumeSell24hUSD` number, nullable
        - `organicBuys1min` number, nullable
        - `organicBuys5min` number, nullable
        - `organicBuys15min` number, nullable
        - `organicBuys1h` number, nullable
        - `organicBuys4h` number, nullable
        - `organicBuys6h` number, nullable
        - `organicBuys12h` number, nullable
        - `organicBuys24h` number, nullable
        - `organicSells1min` number, nullable
        - `organicSells5min` number, nullable
        - `organicSells15min` number, nullable
        - `organicSells1h` number, nullable
        - `organicSells4h` number, nullable
        - `organicSells6h` number, nullable
        - `organicSells12h` number, nullable
        - `organicSells24h` number, nullable
        - `organicBuyers1min` number, nullable
        - `organicBuyers5min` number, nullable
        - `organicBuyers15min` number, nullable
        - `organicBuyers1h` number, nullable
        - `organicBuyers4h` number, nullable
        - `organicBuyers6h` number, nullable
        - `organicBuyers12h` number, nullable
        - `organicBuyers24h` number, nullable
        - `organicSellers1min` number, nullable
        - `organicSellers5min` number, nullable
        - `organicSellers15min` number, nullable
        - `organicSellers1h` number, nullable
        - `organicSellers4h` number, nullable
        - `organicSellers6h` number, nullable
        - `organicSellers12h` number, nullable
        - `organicSellers24h` number, nullable
        - `createdAt` string, nullable, required
        - `latestTradeDate` string, nullable, required
        - `holdersCount` number, nullable
        - `description` string, nullable, required
        - `socials` object, required
          - `twitter` string, nullable, required
          - `website` string, nullable, required
          - `telegram` string, nullable, required
          - `others` object, nullable, required
          - `uri` string
        - `security` object, nullable, required
          - `buyTax` string, nullable
          - `sellTax` string, nullable
          - `transferPausable` boolean
          - `top10Holders` string
          - `isBlacklisted` boolean
          - `noMintAuthority` boolean
          - `balanceMutable` boolean
          - `lowLiquidity` string
          - `burnRate` string
          - `liquidityBurnPercentage` number
          - `isHoneypot` boolean
          - `isNotOpenSource` boolean
          - `renounced` boolean
          - `locked` string
          - `isWhitelisted` boolean
          - `isMintable` boolean
          - `modifyableTax` boolean
          - `selfDestruct` boolean
        - `twitterReusesCount` number, nullable
        - `twitterRenameCount` number, nullable
        - `twitterRenameHistory` object[]
          - `username` string, required
          - `lastChecked` string, required
        - `deployerMigrationsCount` number, nullable
        - `deployerTokensCount` number, nullable
        - `securityScore` number, nullable
        - `securityScoreUpdatedAt` string, nullable
        - `dexscreenerListed` boolean, nullable
        - `dexscreenerHeader` string, nullable
        - `dexscreenerAdPaid` boolean, nullable
        - `dexscreenerAdPaidDate` string, nullable
        - `dexscreenerPendingAt` string, nullable
        - `dexscreenerSocialPaid` boolean, nullable
        - `dexscreenerSocialPaidDate` string, nullable
        - `liveStatus` string, nullable, required
        - `liveThumbnail` string, nullable, required
        - `livestreamTitle` string, nullable, required
        - `liveReplyCount` number, nullable, required
        - `dexscreenerBoosted` boolean, nullable
        - `dexscreenerBoostedDate` string, nullable
        - `dexscreenerBoostedAmount` number, nullable
        - `isMayhemMode` boolean, nullable
        - `isCashbackCoin` boolean, nullable
        - `isAgentMode` boolean, nullable
        - `isOGCoin` boolean, nullable
        - `top10HoldingsPercentage` number, nullable
        - `top50HoldingsPercentage` number, nullable
        - `top100HoldingsPercentage` number, nullable
        - `top200HoldingsPercentage` number, nullable
        - `devHoldingsPercentage` number, nullable
        - `insidersHoldingsPercentage` number, nullable
        - `bundlersHoldingsPercentage` number, nullable
        - `snipersHoldingsPercentage` number, nullable
        - `proTradersHoldingsPercentage` number, nullable
        - `freshTradersHoldingsPercentage` number, nullable
        - `smartTradersHoldingsPercentage` number, nullable
        - `insidersCount` number, nullable
        - `bundlersCount` number, nullable
        - `snipersCount` number, nullable
        - `freshTradersCount` number, nullable
        - `proTradersCount` number, nullable
        - `smartTradersCount` number, nullable
        - `freshTradersBuys` number, nullable
        - `proTradersBuys` number, nullable
        - `smartTradersBuys` number, nullable
      - object
        - `error` string
      - unknown
  - `hostname` string

## Other responses

- `402` — Payment Required

---

[API](https://skmtc.net/mobula/apis/mobula-api.md) · [All operations](https://skmtc.net/mobula/apis/mobula-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mobula/mobula-api/versions/32f95d9e8ff2/schema)
