Skip to main content
The Metadata endpoint lets you retrieve detailed metadata for an asset by name, symbol, Mobula ID, or contract address plus blockchain. This is useful for enriching token pages with descriptive and informational fields beyond just market data, across chains like Solana, Ethereum, BNB Chain, Base, and more. Some assets may not have an id if they are not listed on Mobula.

​
What this endpoint does

With this API, you can:
  • Retrieve detailed metadata for an asset, including enriched information when available
  • Query by asset name, symbol, Mobula id, or contract address (with blockchain)
  • Optionally force fresh fetching and return a more enriched metadata payload using force and full

​
What you’ll need

  • Basic knowledge of REST APIs
  • An asset name, symbol, ID, or contract 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 contract addresses to test)

​
When to use Metadata

Use this endpoint when you want to:
  • Enrich an asset or token page with metadata like description, image, ranks, tags, and contracts
  • Retrieve fundraising, tokenomics, investors, and other enriched categories for supported assets
  • Resolve a Mobula internal asset ID from a symbol or asset query
  • Query metadata by contract address when you only have on-chain identifiers
If you want a full asset snapshot with market data and supply stats, use: Asset Details If you want enriched contract-level market stats for a token, use: Token Details If you want token security signals like honeypot flags, taxes, and restrictions, use: Token Security If you want pool-level stats like liquidity and volume for markets where a token trades, use: Market Details

​
Walkthrough to Get Metadata

​
1. Prepare your query

The Metadata endpoint requires one parameter:
ParameterDescription
assetAsset name or contract address. If using a contract address, blockchain is required.
Optional parameters you can use:
  • blockchain: Blockchain identifier, required if asset is a contract address
  • symbol: Symbol of the asset (alternative way to query)
  • id: Mobula internal asset ID (alternative way to query)
  • force: If true, forces fresh data fetching
  • full: If true, returns full enriched metadata when available
Tip: If you query by contract address, pass it in asset and also provide blockchain (example: ethereum, evm:1, or solana).

​
2. Find a token address to test with DexScreener

To get a real contract 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 asset parameter.

​
3. Fill the API form

Either:
  • Enter an asset name, or
  • Enter a symbol, or
  • Paste an id, or
  • Paste a contract address into asset and also set blockchain
(Optional) set full=true for enriched metadata when available, and force=true to trigger a fresh fetch, then click Send.

​
Reviewing the response

The response returns a metadata object for the asset. Depending on the asset, you may see:
  • id: Mobula internal asset ID when available
  • name / symbol: Asset identity fields
  • image / logo: Asset image when available
  • description: Asset description field when available
  • rank: Ranking fields when provided
  • tags / categories: Classification tags when available
  • contracts: Contract information and chain mapping when provided
  • centralization / distribution: Distribution signals when available
  • fundraising / investors / tokenomics: Enriched metadata categories when full=true is supported
Notes:
  • Some assets may not have an id if they are not listed on Mobula.
  • Use full=true to request more enriched metadata when available.
  • Use force=true if you want to trigger a fresh fetch.

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

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

​
Summary

The Metadata endpoint helps you:
  • Retrieve asset metadata by name, symbol, ID, or contract address plus blockchain
  • Use full=true for enriched categories when available and force=true to fetch fresh data
  • Enrich asset pages with description, images, ranks, tags, and contract mapping
  • Visualize metadata instantly in the Asset Metadata Demo UI

​
Try Mobula for Free

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