GET
/
multi-metadata
curl --request GET \
  --url https://api.mobula.io/api/1/multi-metadata
{
  "data": [
    {
      "data": {
        "id": 123,
        "name": "<string>",
        "symbol": "<string>",
        "contracts": [
          "<string>"
        ],
        "blockchains": [
          "<string>"
        ],
        "decimals": [
          123
        ],
        "twitter": "<string>",
        "website": "<string>",
        "logo": "<string>",
        "price": 123,
        "market_cap": 123,
        "liquidity": 123,
        "volume": 123,
        "description": "<string>",
        "kyc": "<string>",
        "audit": "<string>",
        "total_supply_contracts": [
          "<string>"
        ],
        "circulating_supply_addresses": [
          "<string>"
        ],
        "total_supply": 123,
        "circulating_supply": 123,
        "discord": "<string>",
        "max_supply": 123,
        "chat": "<string>",
        "tags": [
          "<string>"
        ],
        "investors": [
          {
            "lead": true,
            "name": "<string>",
            "type": "<string>",
            "image": "<string>",
            "country_name": "<string>",
            "description": "<string>"
          }
        ],
        "distribution": [
          {
            "percentage": 123,
            "name": "<string>"
          }
        ],
        "release_schedule": [
          {
            "allocation_details": {},
            "tokens_to_unlock": 123,
            "unlock_date": 123
          }
        ],
        "cexs": [
          {
            "logo": "<string>",
            "name": "<string>",
            "id": "<string>"
          }
        ],
        "listed_at": "<string>"
      }
    }
  ]
}

Query details

You can query metadata for multiple assets at the same time. Input the names of the assets or the contract addresses with the respective blockchains as parameters. The market data asset query pattern is explained in great details here, with blockchain format, etc.

For example, you can query with parameters:

{
  "assets": "Avalanche,0x7d1afa7b718fb893db30a3abc0cfc608aacfebb0,Polkadot,0x23d29d30e35c5e8d321e1dc9a8a61bfd846d4c5c",
  "blockchains": "43114,137,1"
}

We will map the first blockchain with the first contract address found, and so on.

It is also possible to query using symbols - in that situation mobula sorts all assets with the same symbol and returns the one with the highest market cap - particularly useful if you need to map data coming from CEX trading pairs - if symbol is used, asset isn’t mandatory anymore.

Data details

Some assets have enriched data about fundraising, tokenomics, investors, etc., which you can explore on mobula.io. Note that some assets may not have the id field due to them not being listed on Mobula.

Query Parameters

ids
string
assets
string
blockchains
string
symbols
string

Response

200 - application/json
Multi metadata response
data
object[]
required