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

​
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
Example:

"0xBd3531dA5CF5857e7CfAA92426877b022e612cf8"

Query Parameters

​
limit
integer
default:20

Number of items to return in a response

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

Use the cursor value returned from the response to fetch the next page of results

Response

200
application/json
Successful Response
​
items
object[]
​
cursor
string
​
error
string