Skip to main content
The Asset Details endpoint lets you retrieve asset-level information across chains in one request. This includes metadata, market data, supply statistics, and detailed token information for each contract linked to the asset across chains like Solana, Ethereum, BNB Chain, Base, and more. You can query by Mobula asset ID, or by token address and blockchain.

​
What this endpoint does

With this API, you can:
  • Retrieve comprehensive asset-level data including metadata, market statistics, and supply stats
  • Aggregate data at the asset level and return token details for associated contracts across chains
  • Query by id (Mobula asset ID), or address + blockchain (resolve the asset from a token contract)
  • Control how many token contracts return enriched details using tokensLimit
  • Batch query multiple assets in a single request using POST

​
What you’ll need

  • Basic knowledge of REST APIs
  • An asset ID or token address (depending on how you query)
  • A Mobula API key
Note: All Mobula endpoints require an API key.
Get a free API key: Here Optional:
  • DexScreener (to find token addresses to test)

​
When to use Asset Details

Use this endpoint when you want to:
  • Retrieve a complete asset snapshot across chains, not just one token contract
  • Display asset metadata like name, symbol, logo, description, rank, and socials
  • Pull supply and valuation fields like total supply, circulating supply, and market cap
  • List token contracts linked to the same asset and show token-level market stats
  • Build multi-chain dashboards that need asset-level aggregation
If you want contract-level enriched data for a single token, use: Token Details If you want token security signals like honeypot flags, taxes, and restrictions, use: Token Security If you want market-level pool stats like liquidity, volume, and price changes, use: Market Details If you want all markets (pairs) for a token across DEXes, use: Token Markets

​
Walkthrough to Get Asset Details

​
1. Prepare your query

The Asset Details endpoint supports two query modes:
ParameterDescription
idMobula asset ID. Use this to query the asset directly. Required if address is not provided.
addressToken contract address (EVM) or token mint address (Solana). Required if id is not provided and must be used with blockchain.
blockchainBlockchain identifier (example: evm:1, solana, ethereum). Required when using address.
Optional parameters you can use:
  • tokensLimit: Maximum number of tokens to return enriched detailed data for (default: 10, max: 50)
Tip: Provide either id, or address + blockchain. You do not need both.

​
2. Find a token address to test with DexScreener

To get a real token address:
  • Open DexScreener
  • Pick a token
  • Open its token page (or open a pair page for the token)
  • Copy the token contract address (or Solana mint address)
  • Note the chain the token is on (you will use this for blockchain)
This address is used as the address parameter.

​
3. Fill the API form

Either:
  • Paste an id, or
  • Paste address and blockchain
(Optional) set tokensLimit if needed, then click Send.

​
Reviewing the response

The response contains one main object with asset-level info and token-level info. Asset object
  • asset.id: Unique asset identifier in Mobula
  • asset.name / asset.symbol: Asset name and ticker
  • asset.logo / asset.description: Display metadata for UIs
  • asset.rank: Market cap rank when available
  • asset.nativeChainId: Native chain if this is a native coin
  • asset.priceUSD: Current price in USD
  • asset.totalSupply / asset.circulatingSupply: Supply statistics
  • asset.marketCapUSD / asset.marketCapDilutedUSD: Market cap and fully diluted market cap
  • asset.athPriceUSD / asset.athPriceDate: All-time high price and date when available
  • asset.atlPriceUSD / asset.atlPriceDate: All-time low price and date when available
  • asset.socials: Links like website, Twitter, GitHub, Discord when available
Tokens array
  • tokens[]: Token contracts associated with this asset
  • Token objects in tokens[] include the same type of enriched fields you get from Token Details, such as price, liquidity, volume, and more
  • tokensCount: Total number of tokens associated with the asset (may be higher than the number returned if tokensLimit is smaller)
tokensLimit tip
  • Use a lower tokensLimit for faster responses when you only need the top token contracts
  • Increase tokensLimit when you need more detailed contract coverage for the asset

​
Try It Live with Mobula Asset Details Demo (UI)

You can also test this endpoint using our demo UI: Demo UI Homepage Asset Details Demo UI Docs

​
Summary

The Asset Details endpoint helps you:
  • Retrieve asset-level metadata, market data, and supply stats across chains
  • Query by Mobula asset ID or by token address plus blockchain
  • Use tokensLimit to control how many associated token contracts return enriched details
  • Visualize results instantly in the Asset Details Demo UI

​
Try Mobula for Free

Try our free API today and start building in minutes.
Get your free API key: Here