Skip to main content
POST
/
v0
/
tokens
/
metadata
Get Tokens Metadata
curl --request POST \
  --url https://api.bubblemaps.io/v0/tokens/metadata \
  --header 'Content-Type: application/json' \
  --header 'X-ApiKey: <api-key>' \
  --data '
[
  {
    "chain": "eth",
    "address": "<string>"
  }
]
'
[
  {
    "token_key": {
      "chain": "eth",
      "address": "<string>"
    },
    "metadata": {
      "name": "<string>",
      "symbol": "<string>",
      "is_indexed": true,
      "img_url": "<string>"
    }
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.bubblemaps.io/llms.txt

Use this file to discover all available pages before exploring further.

Credit cost: 0.1 per token.
Get metadata for a batch of tokens. Token list is passed as query body. The parameter return_token_stats will get you some stats about the tokens. Costs 0.5 credit per token instead of 0.1. -> link index tokens

Authorizations

​
X-ApiKey
string
header
required

Query Parameters

​
return_token_stats
boolean
default:false

Body

application/json
Maximum array length: 1000
​
chain
enum<string>
required
Available options:
eth,
base,
solana,
tron,
bsc,
apechain,
sonic,
ton,
avalanche,
polygon,
monad
​
address
string
required
Example:
[
  {
    "chain": "eth",
    "address": "0x1f9840a85d5af5bf1d1762f925bdaddc4201f984"
  },
  {
    "chain": "base",
    "address": "0x940181a94a35a4569e4529a3cdfb74e38fd98631"
  }
]

Response

Successful Response

​
token_key
TokenKey · object
required
​
metadata
TokenMetadata · object
required