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 Tokens by Contract
This API returns all NFT tokens that belong to a given contract.
GET
/
api
/
v1
/
developer
/
nfts
/
contracts
/
{chain}
/
{contract_address}
/
tokens
curl --request GET \
--url https://api.allium.so/api/v1/developer/nfts/contracts/{chain}/{contract_address}/tokens \
--header 'X-API-KEY: <api-key>'
{
"items": [
{
"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
}
}
}
}
],
"cursor": "<string>",
"error": "<string>"
}
Authorizations
Headers
Path Parameters
Available options:
ethereum
, abstract
, apechain
, arbitrum
, arbitrum-nova
, avalanche
, base
, optimism
, polygon
, shape
, soneium
, xai
, zero
, zora
Example:
"0xBd3531dA5CF5857e7CfAA92426877b022e612cf8"
Query Parameters
Number of items to return in a response
Required range:
1 <= x <= 200
Use the cursor value returned from the response to fetch the next page of results
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}/tokens \
--header 'X-API-KEY: <api-key>'
{
"items": [
{
"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
}
}
}
}
],
"cursor": "<string>",
"error": "<string>"
}