Skip to main content
GET
/
v1
/
nft
/
{collectionAddress}
/
assets
cURL
curl --request GET \
  --url 'https://openapiv1.coinstats.app/v1/nft/0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d/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
  • collectionAddress: Path parameter. NFT collection contract address.
  • 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

Response

​
meta
object
required
​
data
object[]