Blockchain - Token Metadata
curl --request GET \
--url https://public-api.birdeye.so/blockchain/v1/token/metadata \
--header 'X-API-KEY: <api-key>'import requests
url = "https://public-api.birdeye.so/blockchain/v1/token/metadata"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://public-api.birdeye.so/blockchain/v1/token/metadata', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": {
"supply": 1,
"decimals": 0,
"is_initialized": true,
"mint_authority": "HZZKPtYNXzvD7UUNA5BAJdTV6waECFQ4bYV2VrfVyDfk",
"freeze_authority": "HZZKPtYNXzvD7UUNA5BAJdTV6waECFQ4bYV2VrfVyDfk",
"is_nft": true,
"key": "MetadataV1",
"update_authority": "3bwq8YJDGQN6GJfGjcrkCTKT2g2LCzBdgtg6x7PmE3Fz",
"name": "Magellanic Clouds",
"symbol": "",
"uri": "https://bafkreiblcmp6u7j6fdspyr7sf2igpbipihqexecj3d4mg43brpxfombnxm.ipfs.dweb.link?ext=",
"seller_fee_basis_points": 1000,
"creators": [
{
"address": "3bwq8YJDGQN6GJfGjcrkCTKT2g2LCzBdgtg6x7PmE3Fz",
"verified": true,
"share": 98
},
{
"address": "tsU33UT3K2JTfLgHUo7hdzRhRe4wth885cqVbM8WLiq",
"verified": true,
"share": 2
}
],
"primary_sale_happened": false,
"is_mutable": true,
"edition_nonce": 253,
"token_standard": "NonFungible",
"collection": {
"verified": true,
"key": "H2MmeHoKSTzmfmtd8HDEfTtTbDFsXKbnDA6Ec2Pjrvvc"
}
}
}{
"success": false,
"message": "Bad request"
}{
"success": false,
"message": "Unauthorized"
}{
"success": false,
"message": "Access Denied"
}{
"success": false,
"message": "Too many requests"
}{
"success": false,
"message": "Internal Server Error"
}Token
Blockchain - Token Metadata
Returns metadata for a Solana token mint.
GET
/
blockchain
/
v1
/
token
/
metadata
Blockchain - Token Metadata
curl --request GET \
--url https://public-api.birdeye.so/blockchain/v1/token/metadata \
--header 'X-API-KEY: <api-key>'import requests
url = "https://public-api.birdeye.so/blockchain/v1/token/metadata"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://public-api.birdeye.so/blockchain/v1/token/metadata', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": {
"supply": 1,
"decimals": 0,
"is_initialized": true,
"mint_authority": "HZZKPtYNXzvD7UUNA5BAJdTV6waECFQ4bYV2VrfVyDfk",
"freeze_authority": "HZZKPtYNXzvD7UUNA5BAJdTV6waECFQ4bYV2VrfVyDfk",
"is_nft": true,
"key": "MetadataV1",
"update_authority": "3bwq8YJDGQN6GJfGjcrkCTKT2g2LCzBdgtg6x7PmE3Fz",
"name": "Magellanic Clouds",
"symbol": "",
"uri": "https://bafkreiblcmp6u7j6fdspyr7sf2igpbipihqexecj3d4mg43brpxfombnxm.ipfs.dweb.link?ext=",
"seller_fee_basis_points": 1000,
"creators": [
{
"address": "3bwq8YJDGQN6GJfGjcrkCTKT2g2LCzBdgtg6x7PmE3Fz",
"verified": true,
"share": 98
},
{
"address": "tsU33UT3K2JTfLgHUo7hdzRhRe4wth885cqVbM8WLiq",
"verified": true,
"share": 2
}
],
"primary_sale_happened": false,
"is_mutable": true,
"edition_nonce": 253,
"token_standard": "NonFungible",
"collection": {
"verified": true,
"key": "H2MmeHoKSTzmfmtd8HDEfTtTbDFsXKbnDA6Ec2Pjrvvc"
}
}
}{
"success": false,
"message": "Bad request"
}{
"success": false,
"message": "Unauthorized"
}{
"success": false,
"message": "Access Denied"
}{
"success": false,
"message": "Too many requests"
}{
"success": false,
"message": "Internal Server Error"
}- Usage Note
- Accessibility
- Chain Supported
- Returns mint-level metadata and Metaplex metadata for one Solana token mint.
- Useful for both fungible tokens and NFTs;
is_nftandtoken_standardhelp separate the two. mint_authorityandfreeze_authoritymay benullwhen those controls have been removed.uripoints to off-chain metadata and should be treated as external content that can change or disappear.
- Standard
- Lite
- Starter
- Premium
- Business
- Enterprise
Solana
Use Cases 💡
Use Cases 💡
- Fetch Solana mint metadata for wallets, galleries, explorers, and internal tooling.
- Check token authorities, mutability, and royalty fields before listing or supporting an asset.
- Distinguish fungible tokens, NFTs, and collection-linked assets from one endpoint.
- Hydrate token cards and token detail pages with on-chain metadata before reading off-chain JSON.
How to Use 🛠️
How to Use 🛠️
- Pass the mint address in
token. - Read
decimals,supply, andis_initializedfor mint-level basics. - Use
update_authority,is_mutable, andcollectionwhen you need NFT or creator checks. - Fetch and cache the off-chain
uriseparately if your application needs artwork or extended attributes.
Best Practices ✅
Best Practices ✅
- Cache this metadata more aggressively than price or trade data.
- Treat off-chain URI content as untrusted input and validate it before display.
- Combine this endpoint with account detail or token-account queries when you need both metadata and holdings.
Limitations ⚠️
Limitations ⚠️
- Solana only.
Was this page helpful?

