Get Nft Collection Assets By Address

Get the list of NFT assets associated with NFT Collection by collectionAddress.

curl --request GET \
  --url https://openapiv1.coinstats.app/nft/{collectionAddress}/assets \
  --header 'X-API-KEY: <api-key>'

{
  "meta": {
    "page": 2,
    "limit": 20,
    "itemCount": 150,
    "pageCount": 8,
    "hasPreviousPage": true,
    "hasNextPage": true
  },
  "data": [
    {
      "address": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
      "blockchain": "ethereum",
      "tokenId": "0",
      "attributes": [
        {
          "key": "Background",
          "kind": "string",
          "value": "Orange",
          "tokenCount": 1274,
          "onSaleCount": 41,
          "floorAskPrice": 10.5,
          "topBidValue": 10,
          "createdAt": "2024-01-27T07:15:58.523Z"
        },
        {
          "key": "Clothes",
          "kind": "string",
          "value": "Striped Tee",
          "tokenCount": 412,
          "onSaleCount": 10,
          "floorAskPrice": 10.72,
          "topBidValue": null,
          "createdAt": "2024-01-27T07:15:58.719Z"
        }
      ],
      "collectionId": "e1d92f9a882dd4db91feabe806a326af",
      "name": null,
      "previewUrl": "https://img.reservoir.tools/images/v2/mainnet/7%2FrdF%2Fe%2F0iXY8HduhRCoIehkmFeXPeOQQFbbmIPfjCZeLloToqp073iyCX%2FAT3E6uYDqjoHHp1CsuC3u6gJ%2BxixS6XKRAFdBaJMUefz4QR69ZDW9ItgF7Bv047qTmFku0Hxt5Ib2RmfppbDYaFxKWQ%3D%3D",
      "rarityRank": 2673,
      "rarityScore": 75.409,
      "source": "reservoir",
      "standard": "ERC721",
      "url": "https://img.reservoir.tools/images/v2/mainnet/i9YO%2F4yHXUdJsWcTqhqvf%2BytcG2XMhnD4zz%2BhMYH9%2FZK%2FhVtu%2B3gYAAVBBdL1dsMoZPY79XY4AQ%2FN91VDNlxaLilzKrcVKu%2FcHUBfdHr%2BSM%3D",
      "lastSaleDate": "2024-01-15T10:30:00.000Z",
      "lastSalePrice": 15.75,
      "listSource": "opensea",
      "listPrice": 20.5
    }
  ]
}

GET

nft

{collectionAddress}

assets

Get the list of NFT assets associated with NFT Collection by collectionAddress.

curl --request GET \
  --url https://openapiv1.coinstats.app/nft/{collectionAddress}/assets \
  --header 'X-API-KEY: <api-key>'

{
  "meta": {
    "page": 2,
    "limit": 20,
    "itemCount": 150,
    "pageCount": 8,
    "hasPreviousPage": true,
    "hasNextPage": true
  },
  "data": [
    {
      "address": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
      "blockchain": "ethereum",
      "tokenId": "0",
      "attributes": [
        {
          "key": "Background",
          "kind": "string",
          "value": "Orange",
          "tokenCount": 1274,
          "onSaleCount": 41,
          "floorAskPrice": 10.5,
          "topBidValue": 10,
          "createdAt": "2024-01-27T07:15:58.523Z"
        },
        {
          "key": "Clothes",
          "kind": "string",
          "value": "Striped Tee",
          "tokenCount": 412,
          "onSaleCount": 10,
          "floorAskPrice": 10.72,
          "topBidValue": null,
          "createdAt": "2024-01-27T07:15:58.719Z"
        }
      ],
      "collectionId": "e1d92f9a882dd4db91feabe806a326af",
      "name": null,
      "previewUrl": "https://img.reservoir.tools/images/v2/mainnet/7%2FrdF%2Fe%2F0iXY8HduhRCoIehkmFeXPeOQQFbbmIPfjCZeLloToqp073iyCX%2FAT3E6uYDqjoHHp1CsuC3u6gJ%2BxixS6XKRAFdBaJMUefz4QR69ZDW9ItgF7Bv047qTmFku0Hxt5Ib2RmfppbDYaFxKWQ%3D%3D",
      "rarityRank": 2673,
      "rarityScore": 75.409,
      "source": "reservoir",
      "standard": "ERC721",
      "url": "https://img.reservoir.tools/images/v2/mainnet/i9YO%2F4yHXUdJsWcTqhqvf%2BytcG2XMhnD4zz%2BhMYH9%2FZK%2FhVtu%2B3gYAAVBBdL1dsMoZPY79XY4AQ%2FN91VDNlxaLilzKrcVKu%2FcHUBfdHr%2BSM%3D",
      "lastSaleDate": "2024-01-15T10:30:00.000Z",
      "lastSalePrice": 15.75,
      "listSource": "opensea",
      "listPrice": 20.5
    }
  ]
}

8 credits per request

Required

collectionAddress: Path parameter. NFT collection contract address.

Optional

page & limit: Control pagination.
rarity: Filter assets by rarity.

Authorizations

X-API-KEY

string

header

required

API key required to access the endpoints. Generate one from your dashboard at https://openapi.coinstats.app and pass it in the X-API-KEY request header. Never expose your key in client-side code.

Path Parameters

collectionAddress

string

required

The address of the NFT collection

Example:

"0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d"

Query Parameters

page

number

Page number to retrieve (1-based indexing)

Example:

1

limit

number

Number of items to return per page

Example:

20

type

enum<string>

Available options:

listed,

all

Authorizations

Path Parameters

Query Parameters

Response