GET
/
api
/
v1
/
developer
/
nfts
/
listings
/
{chain}
/
{contract_address}
curl --request GET \
  --url https://api.allium.so/api/v1/developer/nfts/listings/{chain}/{contract_address} \
  --header 'X-API-KEY: <api-key>'
{
  "items": [
    {
      "chain": "<string>",
      "contract_address": "<string>",
      "token_id": "<string>",
      "maker": "<string>",
      "source": "<string>",
      "status": "active",
      "price": {}
    }
  ],
  "cursor": "<string>",
  "error": "<string>"
}

Authorizations

​
X-API-KEY
string
header
required

Headers

​
x-allium-team-id
string

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.

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

200
application/json

Successful Response

The response is of type object.

GET
/
api
/
v1
/
developer
/
nfts
/
listings
/
{chain}
/
{contract_address}
curl --request GET \
  --url https://api.allium.so/api/v1/developer/nfts/listings/{chain}/{contract_address} \
  --header 'X-API-KEY: <api-key>'
{
  "items": [
    {
      "chain": "<string>",
      "contract_address": "<string>",
      "token_id": "<string>",
      "maker": "<string>",
      "source": "<string>",
      "status": "active",
      "price": {}
    }
  ],
  "cursor": "<string>",
  "error": "<string>"
}

Authorizations

​
X-API-KEY
string
header
required

Headers

​
x-allium-team-id
string

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.

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

200
application/json

Successful Response

The response is of type object.