> ## 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.
# Get Metadata
> Retrieve detailed metadata for an asset, including fundraising, tokenomics, investors, and more. Works with asset name or contract address + blockchain ID. Some assets may not have an id if they are not listed on Mobula.
Field coverage is compared across aggregators live on [OpenChainBench](https://openchainbench.com/benchmarks/metadata-coverage), the open benchmark suite we built and open-sourced.
[](https://openchainbench.com/benchmarks/metadata-coverage)
### Query Details
Input in “asset” the name of the asset you want to query, or the contract address while adding the blockchain as a second parameter. The market data asset query pattern is explained [in great details here](/rest-api-reference/docs/market-asset-query), with blockchain format, etc.
| Name | Required | Description |
| - | - | - |
| `asset` | Yes | Asset name or contract address. |
| `blockchain` | No | Blockchain identifier (required if using contract address). |
| `symbol` | No | Symbol of the asset. |
| `id` | No | Mobula internal asset ID. |
| `force` | No | If `true`, forces fresh data fetching. |
| `full` | No | If `true`, returns full enriched metadata`categories`, `investors`,`distribution` etc., |
Some assets, which you can explore on mobula.io (example: Avalanche) also have enriched data about fundraising, tokenomics, investors, etc.
Some assets won't have the id field, due to them not being listed on Mobula.
### Usage Examples
* Query by `Asset Address` & `blockchain`
```bash theme={null}
curl -X GET "https://demo-api.mobula.io/api/1/metadata?asset=0x504E4b2E72b6de62BCbB5E4eB5587962Ce41852a&blockchain=ethereum"
```
* Query by `Asset Name` with `full=true` and `force=true`
```bash theme={null}
curl -X GET "https://demo-api.mobula.io/api/1/metadata?asset=Avalanche&blockchain=solana&full=true&force=true"
```
-Query by Mobula internal asset `id`
```bash theme={null}
curl -X GET "https://demo-api.mobula.io/api/1/metadata?id=24"
```
## OpenAPI
````yaml get /1/metadata
openapi: 3.0.0
info:
version: 1.0.0
title: Mobula API
description: >-
Documentation of the Mobula API
**Demo API**: The default server (demo-api.mobula.io) is a demo API with
rate limits.
For production use, please use api.mobula.io with an API key from
https://admin.mobula.io
servers:
- url: https://demo-api.mobula.io/api/
description: Demo API (rate limited, for testing only)
- url: https://api.mobula.io/api/
description: Production API (requires API key)
security: []
tags:
- name: V2 - Token
description: Token details, price, security, ATH, and holder data
- name: V2 - Market Data
description: Market details, OHLCV history, and lighthouse metrics
- name: V2 - Trades
description: Token trades, enriched trades, and trade filters
- name: V2 - Wallet
description: Wallet positions, activity, trades, analysis, and labels
- name: V2 - Assets
description: Cross-chain asset details and price history
- name: V2 - Swap
description: Swap quoting and execution
- name: V2 - Perps
description: Perpetual futures quoting, execution, and positions
- name: V2 - Bridge
description: Cross-chain bridge quoting and intent status (Alpha Preview)
- name: V2 - DeFi
description: Bonding pools and pulse data
- name: V2 - Search
description: Universal fast search
- name: V2 - Usage
description: Per-key API and WebSocket usage history
- name: V2 - Blockchains
description: System metadata and chain listings
- name: V2 - Prediction Markets
description: >-
Polymarket markets/events, wallet positions, and the full execution stack
(auth, order build/submit/cancel, approvals, pUSD wrap/unwrap, deploy,
deposit/withdraw, redeem). Alpha — see /api/2/pm/*.
- name: V1 - Market Data
description: Market prices, history, sparklines, pairs, and multi-data
- name: V1 - Wallet
description: Wallet portfolio, transactions, history, and NFTs
- name: V1 - Token
description: First buyers
- name: V1 - Trades
description: Market trades by pair
- name: V1 - Metadata
description: Token metadata, categories, and news
- name: V1 - Assets
description: List all assets
- name: V1 - Search
description: Search for assets, tokens, and pairs
- name: V1 - DeFi
description: Bonding pool pulse data
- name: V1 - Blockchains
description: Blockchain listings, pairs, and stats
- name: V1 - Webhooks
description: Webhook management
- name: V1 - Feed
description: Custom feed creation
paths:
/1/metadata:
get:
tags:
- V1 - Metadata
summary: Get metadata
parameters:
- schema:
type: string
description: Token symbol
required: false
description: Token symbol
name: symbol
in: query
- schema:
type: string
description: Asset ID
required: false
description: Asset ID
name: id
in: query
- schema:
type: string
description: Token contract address
required: false
description: Token contract address
name: asset
in: query
- schema:
type: string
description: Blockchain name or chain ID
required: false
description: Blockchain name or chain ID
name: blockchain
in: query
responses:
'200':
description: Metadata response
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
id:
type: number
nullable: true
name:
type: string
symbol:
type: string
rank:
type: number
nullable: true
contracts:
type: array
items:
type: string
blockchains:
type: array
items:
type: string
decimals:
type: array
items:
type: number
twitter:
type: string
nullable: true
website:
type: string
nullable: true
logo:
type: string
nullable: true
price:
type: number
nullable: true
market_cap:
type: number
liquidity:
type: number
volume:
type: number
description:
type: string
nullable: true
kyc:
type: string
nullable: true
audit:
type: string
nullable: true
total_supply_contracts:
type: array
items:
type: string
circulating_supply_addresses:
type: array
items:
type: string
total_supply:
type: number
circulating_supply:
type: number
discord:
type: string
nullable: true
max_supply:
type: number
nullable: true
chat:
type: string
nullable: true
tags:
type: array
items:
type: string
investors:
type: array
items:
type: object
properties:
lead:
type: boolean
name:
type: string
type:
type: string
image:
type: string
country_name:
type: string
description:
type: string
required:
- lead
- name
- type
- image
- country_name
- description
distribution:
type: array
items:
type: object
properties:
percentage:
type: number
name:
type: string
required:
- percentage
- name
release_schedule:
type: array
items:
type: object
properties:
allocation_details:
type: object
additionalProperties:
type: number
tokens_to_unlock:
type: number
unlock_date:
type: number
required:
- allocation_details
- tokens_to_unlock
- unlock_date
cexs:
type: array
items:
type: object
properties:
logo:
type: string
nullable: true
name:
type: string
nullable: true
id:
type: string
required:
- logo
- name
- id
listed_at:
type: string
nullable: true
deployer:
type: string
nullable: true
source:
type: string
nullable: true
others:
type: object
nullable: true
additionalProperties:
nullable: true
dexscreener_listed:
type: boolean
nullable: true
dexscreener_header:
type: string
nullable: true
dexscreener_ad_paid:
type: boolean
nullable: true
live_status:
type: string
nullable: true
live_thumbnail:
type: string
nullable: true
livestream_title:
type: string
nullable: true
live_reply_count:
type: number
nullable: true
telegram:
type: string
nullable: true
twitterRenameCount:
type: number
nullable: true
twitterRenameHistory:
type: array
nullable: true
items:
type: object
properties:
username:
type: string
last_checked:
type: string
required:
- username
- last_checked
required:
- id
- name
- symbol
- contracts
- blockchains
- decimals
- twitter
- website
- logo
- price
- market_cap
- liquidity
- volume
- description
- kyc
- audit
- total_supply_contracts
- circulating_supply_addresses
- total_supply
- circulating_supply
- discord
- max_supply
- chat
- tags
- investors
- distribution
- release_schedule
- cexs
- listed_at
- deployer
- source
required:
- data
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.