BLblockvision

Order Listing

Changed on

This is used to obtain listing information for a single (with support for multiple in the future) NFT order.

get/nft/order/listings

Request

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

Query parameters

contractAddressstring required

String - The list of addresses of the contract for this NFT collection, beginning with 0x.

tokenIdstring

String - The token ID of the contract to get the listing orders for the NFT contract.

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, and subsequent pages are numbered incrementally.

Response

200

nextPageIndexinteger
totalinteger

Example response

{
  "data": [
    {
      "contractAddress": "0x7efe053548c6d266215795e29d14622235171c6a",
      "tokenId": "3097",
      "createdTime": 1676276864,
      "quantity": 1,
      "currencyAddress": "0x0000000000000000000000000000000000000000",
      "expirationTime": 1676286864,
      "listingTime": 1676276964,
      "marker": "0xeb6a3edc09b2a9fc62ac076eb0c9519d02b09585",
      "marketPlace": "looksrare",
      "orderHash": "0xa3e6a22cb5503fe45ed41c6dbda56c4193fbe391809d533ed50ef56ab610a5fd",
      "status": "active",
      "taker": "0x0000000000000000000000000000000000000000",
      "asset": {
        "contractAddress": "0x7efe053548c6d266215795e29d14622235171c6a",
        "tokenId": "3396",
        "imageUrl": "https://i.nfte.ai/io/o1/31680/8483588188610427597_282570979.webp"
      }
    }
  ],
  "nextPageIndex": 1,
  "total": 100
}

Changes