Skip to main content
GET
/
2
/
asset
/
details
Get asset details
curl --request GET \
  --url https://demo-api.mobula.io/api/2/asset/details
{
  "data": {
    "asset": {
      "id": 123,
      "name": "<string>",
      "symbol": "<string>",
      "logo": "<string>",
      "description": "<string>",
      "rank": 123,
      "nativeChainId": "<string>",
      "priceUSD": 123,
      "athPriceDate": "<string>",
      "athPriceUSD": 123,
      "atlPriceDate": "<string>",
      "atlPriceUSD": 123,
      "createdAt": "<string>",
      "listedAt": "<string>",
      "socials": {
        "audit": "<string>",
        "github": "<string>",
        "twitter": "<string>",
        "website": "<string>",
        "kyc": "<string>",
        "chat": "<string>",
        "discord": "<string>"
      },
      "totalSupply": 0,
      "circulatingSupply": 0,
      "marketCapUSD": 0,
      "marketCapDilutedUSD": 0,
      "isStablecoin": false
    },
    "tokens": [
      {
        "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>",
        "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,
        "securityScore": null,
        "securityScoreUpdatedAt": null,
        "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,
        "isMayhemMode": null,
        "isCashbackCoin": null,
        "isAgentMode": null,
        "isOGCoin": 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
      }
    ],
    "tokensCount": 123
  },
  "hostname": "<string>"
}
Batch Support Available: This endpoint supports batch queries via POST method for fetching multiple assets in a single request. Jump to Batch Query section

​
Overview

The Asset Details endpoint provides comprehensive asset-level data including metadata, market statistics, price changes, and detailed token information for each contract across all supported blockchains. Unlike the Token Details endpoint which focuses on a single token contract, this endpoint aggregates data at the asset level and returns detailed information for all associated tokens.

​
GET Method - Single Asset Query

Retrieve detailed asset information for a single asset, identified either by asset ID or by a token address and blockchain.

​
Query Parameters

  • id (optional) — The asset ID (integer). Use this to query by asset ID directly.
  • address (required if no id) — Token contract address. Must be used together with blockchain.
  • blockchain (required if using address) — The blockchain identifier (e.g., evm:1, solana, ethereum)
  • tokensLimit (optional) — Maximum number of tokens to return detailed data for. Default: 10, Max: 50.

​
Step-by-Step Tutorial and Video Walkthrough

  • Check out the guide: Here

​
Usage Examples

Query by Asset ID: 
curl -X GET "https://api.mobula.io/api/2/asset/details?id=100002536"
Query by Address and Blockchain: 
curl -X GET "https://api.mobula.io/api/2/asset/details?blockchain=ethereum&address=0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
With Custom Token Limit: 
curl -X GET "https://api.mobula.io/api/2/asset/details?id=100002536&tokensLimit=5"

​
Response Format

{
  "data": {
    "asset": {
      "id": 100002536,
      "name": "Ethereum",
      "symbol": "ETH",
      "logo": "https://assets.coingecko.com/coins/images/279/large/ethereum.png",
      "description": "Ethereum is a decentralized platform...",
      "rank": 2,
      "nativeChainId": "evm:1",
      "priceUSD": 3245.67,
      "totalSupply": 120000000,
      "circulatingSupply": 120000000,
      "marketCapUSD": 389480400000,
      "marketCapDilutedUSD": 389480400000,
      "athPriceDate": "2021-11-10T14:24:19.000Z",
      "athPriceUSD": 4878.26,
      "atlPriceDate": "2015-10-21T00:00:00.000Z",
      "atlPriceUSD": 0.42,
      "isStablecoin": false,
      "createdAt": "2015-07-30T00:00:00.000Z",
      "listedAt": "2015-08-07T00:00:00.000Z",
      "socials": {
        "audit": null,
        "github": "https://github.com/ethereum",
        "twitter": "https://twitter.com/ethereum",
        "website": "https://ethereum.org",
        "kyc": null,
        "chat": null,
        "discord": "https://discord.gg/ethereum"
      }
    },
    "tokens": [
      {
        "address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
        "chainId": "evm:1",
        "symbol": "WETH",
        "name": "Wrapped Ether",
        "decimals": 18,
        "priceUSD": 3245.67,
        "marketCapUSD": 11359845000,
        "liquidityUSD": 500000000,
        "volume24hUSD": 1200000000,
        "...": "See Token Details endpoint for full response"
      }
    ],
    "tokensCount": 15
  }
}

​
Response Fields

​
Asset Object

FieldTypeDescription
idnumberUnique asset identifier
namestringAsset name
symbolstringAsset symbol/ticker
logostring | nullURL to the asset logo
descriptionstring | nullAsset description
ranknumber | nullMarket cap rank (1 = highest)
nativeChainIdstring | nullNative chain ID if this is a native coin
priceUSDnumber | nullCurrent price in USD
totalSupplynumberTotal supply
circulatingSupplynumberCirculating supply
marketCapUSDnumberMarket capitalization in USD
marketCapDilutedUSDnumberFully diluted market cap in USD
athPriceDatedate | nullAll-time high price date (fallback from tokens if null)
athPriceUSDnumber | nullAll-time high price in USD (fallback from tokens if null)
atlPriceDatedate | nullAll-time low price date (fallback from tokens if null)
atlPriceUSDnumber | nullAll-time low price in USD (fallback from tokens if null)
isStablecoinbooleanWhether the asset is a stablecoin
createdAtdateAsset creation date
listedAtdate | nullListing date (fallback from oldest token if null)
socialsobject | nullSocial media links (twitter, website, github, etc.)

​
Tokens Array

Each token object in the tokens array contains the same fields as the Token Details endpoint, providing comprehensive on-chain data for each token contract associated with the asset.
FieldDescription
tokensCountTotal number of tokens associated with this asset (may be more than returned based on tokensLimit)

​
Error Responses

Status CodeDescription
400Invalid parameters or missing required fields
404Asset not found
500Internal server error

​
Notes

  • When querying by address and blockchain, the endpoint finds the asset associated with that token and returns data for the entire asset including all its tokens.
  • The tokensLimit parameter controls how many tokens get enriched with detailed trading data. Set a lower limit for faster responses.
  • Token details include real-time trading statistics, holder information, and security flags across all supported DEXes.

​
POST Method - Batch Query

Retrieve asset details for multiple assets in a single request for improved efficiency.

​
Request Body

[
  { "id": 100002536 },
  { "blockchain": "ethereum", "address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2" },
  { "id": 100001566, "tokensLimit": 5 }
]

​
Body Parameters

The request body is an array of objects, where each object contains:
  • id (optional) — The asset ID. Either id OR address + blockchain must be provided.
  • address (optional) — Token contract address. Must be used with blockchain.
  • blockchain (optional) — The blockchain identifier. Required when using address.
  • tokensLimit (optional) — Maximum number of tokens per asset. Default: 10, Max: 50.

​
Usage Examples

curl -X POST "https://api.mobula.io/api/2/asset/details" \
  -H "Content-Type: application/json" \
  -d '[
    { "id": 100002536 },
    { "blockchain": "solana", "address": "So11111111111111111111111111111111111111112" }
  ]'

​
Response Format

{
  "payload": [
    {
      "asset": {
        "id": 100002536,
        "name": "Ethereum",
        "symbol": "ETH",
        ...
      },
      "tokens": [...],
      "tokensCount": 15
    },
    {
      "asset": {
        "id": 100001566,
        "name": "Solana",
        "symbol": "SOL",
        ...
      },
      "tokens": [...],
      "tokensCount": 8
    }
  ]
}

​
Use Cases

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

Query Parameters

​
id
number | null

Asset ID

​
address
string

Token contract address

​
chainId
string

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

​
tokensLimit
number
required

Maximum number of tokens to return (1-50, default: 10)

Required range: 1 <= x <= 50

Response

200 - application/json

Asset details response

​
data
object
required
​
hostname
string