> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mobula.io/llms.txt
> Use this file to discover all available pages before exploring further.

# How to Fetch Multi Asset Metadata Across Ethereum, Solana, BNB, Base & More

> Use the Multi Metadata endpoint to retrieve metadata for multiple assets in a single request using ids, symbols, or contract addresses with matching blockchains.

The [**Multi Metadata**](https://docs.mobula.io/rest-api-reference/endpoint/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](https://docs.mobula.io/blockchains/solana), [Ethereum](https://docs.mobula.io/blockchains/ethereum), [BNB Chain](https://docs.mobula.io/blockchains/bsc), [Base](https://docs.mobula.io/blockchains/base), and more.

This is useful for bulk enrichment when building token lists and dashboards.

***

<div style={{ position: 'relative', paddingBottom: '56.25%', height: 0, overflow: 'hidden' }}>
  <iframe src="https://www.youtube.com/embed/awIYX0JbTiA" title="YouTube video player" style={{ position: 'absolute', top: 0, left: 0, width: '100%', height: '100%', border: 0 }} allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowFullScreen />
</div>

***

## 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](https://admin.mobula.io/)

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**](https://docs.mobula.io/rest-api-reference/endpoint/metadata)

If you want a full asset snapshot with market data and supply stats, use: [**Asset Details**](https://docs.mobula.io/rest-api-reference/endpoint/asset-details)

If you want to find assets first by typing a symbol or name, use: [**Fast Search**](https://docs.mobula.io/rest-api-reference/endpoint/fast-search)

***

## Walkthrough to Get Multi Metadata

### 1. Prepare your query

The Multi Metadata endpoint requires two parameters:

| Parameter     | Description                                                                     |
| ------------- | ------------------------------------------------------------------------------- |
| `assets`      | Comma-separated list of asset names or contract addresses                       |
| `blockchains` | Comma-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](https://mobula-demo-endpoint-production.up.railway.app/)

[Multi Metadata Demo UI](https://mobula-demo-endpoint-production.up.railway.app/multi-metadata)

[Docs](https://docs.mobula.io/rest-api-reference/endpoint/multi-metadata)

***

## Summary

The [**Multi Metadata**](https://docs.mobula.io/rest-api-reference/endpoint/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](https://admin.mobula.io/)