BLblockvision

Retrieve Assets

Changed on

This API is optimized for quickly fetching a list of NFTs with given collection slugs, contract addresses and etc..

get/nft/assets

Request

  • Base URL
    https://api.blockvision.org/v2
  • URL
    https://api.blockvision.org/v2/nft/assets
  • Auth
    API key in header x-api-key

Query parameters

contractAddressListstring[]

The contract address of the NFT contract to get the assets information for. Max limit 5 contracts

collectionSlugstring

String - The collection slug of the NFT contract to get the assets information for.

attributesobject

A list of objects that share common attributes: name and value.

minRarityRankinteger

Integer - The minimum rarity rank(inclusive) of the NFT contracts required to get the assets information for.

maxRarityRankinteger

Integer - The maximum rarity rank(inclusive) of the NFT contracts required to get the assets information for.

sortFieldstring

String - The field that is specified to return the sorted data. Supports either createBlockNumber or floorPrice. createBlockNumber by default.

sortDirectionstring

String - Can be either asc or desc. asc by default.

includeOrderboolean

Return asset order info while this is set to TRUE.

pageSizeinteger

Integer - The number of records showing on each page. 20 by default and up to 50.

pageIndexinteger

Integer - The index of the page to retrieve. The first page is typically indexed as 1(by default), and subsequent pages are numbered incrementally.

Response

200

codeinteger
messagestring

Example response

{
  "code": 200,
  "message": "Success",
  "result": {
    "data": [
      {
        "contractAddress": "0xED5AF388653567Af2F388E6224dC7C4b3241C544",
        "tokenID": "0",
        "asset": {
          "attributes": [
            {
              "traitType": "Type",
              "value": "Human"
            }
          ],
          "contractAddress": "0xED5AF388653567Af2F388E6224dC7C4b3241C544",
          "ercStandard": "erc721",
          "image": "https://ipfs-gateway.blockvision.org/ipfs/QmYDvPAXtiJg7s8JdRBSLWdgSphQdac8j1YuQNNxcGE1hg/0.png",
          "name": "Azuki #0",
          "tokenId": "0",
          "tokenUri": "https://ikzttp.mypinata.cloud/ipfs/QmQFkLSQysj94s5GvTHPyzTxrawwtjgiiYS2TBLgrvw8CW/0",
          "owner": [
            "0x2aE6B0630EBb4D155C6e04fCB16840FFA77760AA"
          ]
        },
        "order": {
          "minListingPrice": "0",
          "bestOfferPrice": "0",
          "lastSalePrice": "0"
        }
      }
    ],
    "nextPageIndex": 2,
    "total": 10001
  }
}

Changes