NFT Token by Contract and Token ID
NFT
- NFT Data Overview
- GETNFT Tokens by Contract
- GETNFT Token by Contract and Token ID
- GETNFT Contract
- GETNFT Collections
- GETNFT Listings by Contract Address
- GETNFT Listings by Token ID
- GETNFT Transfers by Token ID
- GETNFT Transfers by Contract Address
- GETNFT Activities by Token ID
- GETNFT Activities by Contract Address
Wallets
Data Transformations
- Data Transformations Overview
- Filter Data Sources
- Filters
- Workflows
Chains
- Overview
- Solana
- Bitcoin
- Ethereum
- Polygon
- Arbitrum
- Base
- Optimism
- Oasys
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
Available options:
native
, evm_erc20
, evm_erc721
, evm_erc1155
, sol_spltoken_legacy
, sol_spltoken_t22
, sol_nft
, btc_inscription
, btc_brc20
, btc_rune
, sui_token
Available options:
native
, evm_erc20
, evm_erc721
, evm_erc1155
, sol_spltoken_legacy
, sol_spltoken_t22
, sol_nft
, btc_inscription
, btc_brc20
, btc_rune
, sui_token
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>"
}