Skip to main content
GET
/
api
/
v1
/
developer
/
nfts
/
listings
/
{chain}
/
{contract_address}
/
{token_id}
NFT Listings by Token ID
curl --request GET \
  --url https://api.allium.so/api/v1/developer/nfts/listings/{chain}/{contract_address}/{token_id} \
  --header 'X-API-KEY: <api-key>'
{
  "data": {
    "chain": "<string>",
    "contract_address": "<string>",
    "token_id": "<string>",
    "maker": "<string>",
    "source": "<string>",
    "status": "active",
    "price": {}
  },
  "error": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.allium.so/llms.txt

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

Authorizations

​
X-API-KEY
string
header
required

Path Parameters

​
chain
enum<string>
required
Available options:
ethereum,
abstract,
apechain,
arbitrum,
arbitrum-nova,
avalanche,
base,
optimism,
polygon,
shape,
soneium,
xai,
zero,
zora
​
contract_address
string
required

Address of the NFT Contract.

​
token_id
string
required

Token ID of the NFT.

Query Parameters

​
limit
integer
default:20

Number of items to return in a response.

Required range: 1 <= x <= 200
​
cursor
string

Cursor to paginate through results.

Response

Successful Response

​
data
NFTListing · object
​
error
string | null