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,
      "totalSupply": 123,
      "circulatingSupply": 123,
      "marketCapUSD": 123,
      "marketCapChange24hPercent": 123,
      "marketCapDilutedUSD": 123,
      "volume24hUSD": 123,
      "volumeChange24hPercent": 123,
      "volume7dUSD": 123,
      "totalVolumeUSD": 123,
      "totalVolumeChange24hPercent": 123,
      "liquidityUSD": 123,
      "liquidityChange24hPercent": 123,
      "athPriceDate": "2023-11-07T05:31:56Z",
      "athPriceUSD": 123,
      "atlPriceDate": "2023-11-07T05:31:56Z",
      "atlPriceUSD": 123,
      "athLiquidityDate": "2023-11-07T05:31:56Z",
      "athLiquidityUSD": 123,
      "athVolumeDate": "2023-11-07T05:31:56Z",
      "athVolumeUSD": 123,
      "offChainVolumeUSD": 123,
      "offChainVolumeChange24hPercent": 123,
      "priceChange1hPercent": 123,
      "priceChange24hPercent": 123,
      "priceChange7dPercent": 123,
      "priceChange1mPercent": 123,
      "priceChange3mPercent": 123,
      "priceChange6mPercent": 123,
      "priceChange1yPercent": 123,
      "priceChangeYTDPercent": 123,
      "priceChange3yPercent": 123,
      "globalVolume": 123,
      "maxSupply": 123,
      "icoPriceUSD": 123,
      "isStablecoin": true,
      "binanceId": "<string>",
      "coingeckoId": "<string>",
      "dropstabId": "<string>",
      "protocolId": 123,
      "createdAt": "2023-11-07T05:31:56Z",
      "listedAt": "2023-11-07T05:31:56Z",
      "socials": {
        "audit": "<string>",
        "github": "<string>",
        "twitter": "<string>",
        "website": "<string>",
        "kyc": "<string>",
        "chat": "<string>",
        "discord": "<string>"
      }
    },
    "tokens": [
      {}
    ],
    "tokensCount": 123
  },
  "hostname": "<string>"
}

​
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.

​
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

Asset ID. Either id or address + blockchain must be provided.

​
address
string

Token contract address. Must be used with blockchain.

​
blockchain
string

Blockchain identifier (e.g., 'ethereum', 'solana'). Required when using address.

​
tokensLimit
number
default:10

Maximum number of tokens to return detailed data for. Default: 10, Max: 100.

Required range: 1 <= x <= 100
​
instanceTracking
boolean

If true, includes the hostname in the response.

Response

Asset details response

​
data
object
required
​
hostname
string

Server hostname (only if instanceTracking is true)