Skip to main content
The Multi Metadata endpoint lets you retrieve metadata for multiple assets in a single request. You can query by Mobula asset IDs, asset names, symbols, or contract addresses with matching blockchains across chains like Solana, Ethereum, BNB Chain, Base, and more. This is useful for bulk enrichment when building token lists and dashboards.

​
What this endpoint does

With this API, you can:
  • Retrieve metadata for multiple assets at the same time
  • Query using ids (Mobula asset IDs), assets (asset names or contract addresses), or symbols (token symbols)
  • Use blockchains to match contract addresses passed in assets
  • Map the first blockchain with the first contract address, and so on
  • When symbols are used, return the asset with the highest market cap for that symbol

​
What you’ll need

  • Basic knowledge of REST APIs
  • A list of asset IDs, symbols, or contract addresses (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 contract addresses to test)

​
When to use Multi Metadata

Use this endpoint when you want to:
  • Enrich a token list with metadata in one request instead of calling /metadata repeatedly
  • Map CEX symbols to asset metadata using the symbols parameter
  • Fetch metadata for many contract addresses across Solana and EVM chains
  • Build dashboards that need logos, websites, Twitter links, and metadata fields in bulk
  • Retrieve enriched metadata for supported assets when available
If you want metadata for a single asset, use: Metadata If you want a full asset snapshot with market data and supply stats, use: Asset Details If you want to find assets first by typing a symbol or name, use: Fast Search

​
Walkthrough to Get Multi Metadata

​
1. Prepare your query

The Multi Metadata endpoint requires two parameters:
ParameterDescription
assetsComma-separated list of asset names or contract addresses
blockchainsComma-separated blockchain name(s) used to match contract addresses in assets
Optional parameters you can use:
  • ids: Comma-separated list of Mobula asset IDs
  • symbols: Comma-separated list of token symbols
Tip: If you pass contract addresses in assets, you must also pass blockchains with the same number of entries in the same order.

​
2. Find token addresses to test with DexScreener

To get real contract addresses:
  • 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 blockchains)
  • Repeat for a second token if you want to test multiple entries
These addresses are used as the assets parameter.

​
3. Fill the API form

Either:
  • Enter a comma-separated assets list and a comma-separated blockchains list (same number of entries, same order), or
  • Enter ids (comma-separated), or
  • Enter symbols (comma-separated)
Then click Send.

​
Reviewing the response

The response returns an array of metadata objects, one per matched asset. Depending on the asset, you may see:
  • Asset identity fields: name, symbol, and id when available
  • Logo and visuals: image or logo fields when provided
  • Social links: Twitter and website fields when available
  • Descriptions and tags: some assets include descriptions, ranks, and classification tags
  • Contracts: contract mapping fields when returned
Important behavior notes:
  • When using assets + blockchains with contract addresses, the endpoint maps the first blockchain to the first address, and so on.
  • When using symbols, Mobula returns the asset with the highest market cap for that symbol.
  • Some assets may not have an id if they are not listed on Mobula.

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

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

​
Summary

The Multi Metadata endpoint helps you:
  • Retrieve metadata for multiple assets in one request
  • Query using ids, assets with blockchains, or symbols for fast mapping
  • Bulk enrich token lists with socials, logos, and descriptive metadata
  • Visualize results instantly in the Multi Metadata Demo UI

​
Try Mobula for Free

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