> ## 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 Asset Metadata Across Ethereum, Solana, BNB, Base & More

> Use the Metadata endpoint to retrieve detailed metadata for an asset by name, symbol, Mobula ID, or contract address plus blockchain.

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

Some assets may not have an `id` if they are not listed on Mobula.

***

<div style={{ position: 'relative', paddingBottom: '56.25%', height: 0, overflow: 'hidden' }}>
  <iframe src="https://www.youtube.com/embed/3YVaW0l640c" 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 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](https://admin.mobula.io/)

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

If you want enriched contract-level market stats for a token, use: [**Token Details**](https://docs.mobula.io/rest-api-reference/endpoint/token-details)

If you want token security signals like honeypot flags, taxes, and restrictions, use: [**Token Security**](https://docs.mobula.io/rest-api-reference/endpoint/token-security-get)

If you want pool-level stats like liquidity and volume for markets where a token trades, use: [**Market Details**](https://docs.mobula.io/rest-api-reference/endpoint/market-details)

***

## Walkthrough to Get Metadata

### 1. Prepare your query

The Metadata endpoint requires one parameter:

| Parameter | Description                                                                            |
| --------- | -------------------------------------------------------------------------------------- |
| `asset`   | Asset 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](https://mobula-demo-endpoint-production.up.railway.app/)

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

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

***

## Summary

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