BLblockvision

Collection Activity

Changed on

This API can be used to build a feed for a collection. Data like event type, amount, relative addresses will be returned.

get/nft/activity/collection

Request

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

Query parameters

contractAddressListstring[]

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

collectionSlugListstring[]

The slug list of the NFT contract to get the collection activity information for.

eventTypeListstring[]

The returned data will be filtered by event types using this array of strings. Supports "Sale,Minted,List,Offer,Transfer,CollectionOffer,BidCancel,Cancel,".

sortFiledstring

String - The field that is specified to return the sorted data. Only supports 'eventTime' at this stage.

sortDirectionstring

String - The order of the returned data sorted by time. Can be either 'asc' or 'desc'(default).

startTimestampinteger

Integer - The timestamp that marks the beginning of the returned data.

endTimestampinteger

Integer - The timestamp that marks the end of the returned data.

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

codeinteger
messagestring

Example response

{
  "code": 200,
  "message": "Success",
  "result": {
    "data": [
      {
        "contractAddress": "0xed5af388653567af2f388e6224dc7c4b3241c544",
        "tokenId": "7244",
        "from": "0xd0809508c07b18c8692bba6ad3ff8014ca193a45",
        "eventTime": 1680201827,
        "imageUrl": "https://ipfs-gateway.blockvision.org/ipfs/QmYDvPAXtiJg7s8JdRBSLWdgSphQdac8j1YuQNNxcGE1hg/7244.png",
        "nftName": "Azuki #7244",
        "marketplace": "looksRare",
        "amount": 1,
        "currentPrice": "18888800000000000000",
        "currencyContract": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
        "eventType": "listing"
      }
    ],
    "nextPageIndex": 2
  }
}

Changes