NFT Token by Contract and Token ID
NFT
Wallets
Data Transformations
- Data Transformations Overview
- Filter Data Sources
- Filters
- Workflows
Chains
- Overview
- Solana
- Bitcoin
- Ethereum
- Polygon
- Arbitrum
- Base
- Optimism
- Oasys
- Monad Testnet
Deep Dives
NFT Token by Contract and Token ID
This API returns NFT token metadata by contract and token ID. For Solana, pass in a token ID of 0.
GET
/
api
/
v1
/
developer
/
nfts
/
contracts
/
{chain}
/
{contract_address}
/
{token_id}
curl --request GET \
--url https://api.allium.so/api/v1/developer/nfts/contracts/{chain}/{contract_address}/{token_id} \
--header 'X-API-KEY: <api-key>'
{
"data": {
"address": "<string>",
"token_id": "<string>",
"token_standard": "<string>",
"name": "<string>",
"description": "<string>",
"metadata": {
"image_original": "<string>",
"media_original": "<string>",
"image_mime_type": "<string>",
"token_uri": "<string>"
},
"image_url": "<string>",
"media_url": "<string>",
"external_url": "<string>",
"attributes": [
{
"key": "<string>",
"value": "<string>"
}
],
"token_account_address": "<string>",
"creators": [
{
"address": "<string>",
"share": 123,
"verified": 123
}
],
"collection_name": "<string>",
"collection_symbol": "<string>",
"collection_count": 123,
"floor_price": {
"asset": {
"type": "native",
"name": "<string>",
"symbol": "<string>",
"decimals": 123,
"token_id": "<string>"
},
"amount": {
"raw_amount": "<string>",
"amount_str": "<string>",
"amount": 123
}
},
"last_sale_price": {
"asset": {
"type": "native",
"name": "<string>",
"symbol": "<string>",
"decimals": 123,
"token_id": "<string>"
},
"amount": {
"raw_amount": "<string>",
"amount_str": "<string>",
"amount": 123
}
},
"rarity": {
"ranking": {
"source": "magic_eden_instant",
"value": 123
},
"metadata": {
"magic_eden_instant": {
"rank": 123
},
"howrare": {
"rank": 123
},
"moonrank": {
"rank": 123
}
}
}
},
"error": "<string>"
}
Authorizations
Headers
Path Parameters
Available options:
ethereum
, abstract
, apechain
, arbitrum
, arbitrum-nova
, avalanche
, base
, optimism
, polygon
, shape
, soneium
, xai
, zero
, zora
, solana
Example:
"0xBd3531dA5CF5857e7CfAA92426877b022e612cf8"
Token ID for EVM chain NFTs. Pass in 0 for solana.
Response
200
application/json
Successful Response
The response is of type object
.
curl --request GET \
--url https://api.allium.so/api/v1/developer/nfts/contracts/{chain}/{contract_address}/{token_id} \
--header 'X-API-KEY: <api-key>'
{
"data": {
"address": "<string>",
"token_id": "<string>",
"token_standard": "<string>",
"name": "<string>",
"description": "<string>",
"metadata": {
"image_original": "<string>",
"media_original": "<string>",
"image_mime_type": "<string>",
"token_uri": "<string>"
},
"image_url": "<string>",
"media_url": "<string>",
"external_url": "<string>",
"attributes": [
{
"key": "<string>",
"value": "<string>"
}
],
"token_account_address": "<string>",
"creators": [
{
"address": "<string>",
"share": 123,
"verified": 123
}
],
"collection_name": "<string>",
"collection_symbol": "<string>",
"collection_count": 123,
"floor_price": {
"asset": {
"type": "native",
"name": "<string>",
"symbol": "<string>",
"decimals": 123,
"token_id": "<string>"
},
"amount": {
"raw_amount": "<string>",
"amount_str": "<string>",
"amount": 123
}
},
"last_sale_price": {
"asset": {
"type": "native",
"name": "<string>",
"symbol": "<string>",
"decimals": 123,
"token_id": "<string>"
},
"amount": {
"raw_amount": "<string>",
"amount_str": "<string>",
"amount": 123
}
},
"rarity": {
"ranking": {
"source": "magic_eden_instant",
"value": 123
},
"metadata": {
"magic_eden_instant": {
"rank": 123
},
"howrare": {
"rank": 123
},
"moonrank": {
"rank": 123
}
}
}
},
"error": "<string>"
}