nft_collectionAuctionRecords
Quickly query the historical auction records of any NFT collection.
You can specify the contract address, then you can obtain all auction records related to the collection, including currency, marketplace, etc. Using this API, you could clearly see the thorough auction records of certain collection.
Supported on Ethereum and BNB Chain.

Parameters

Object - An object with the following fields (required):
  • contractAddress(hex string, required) - the contract address of the collection. BlockVision currently support both ERC721 and ERC1155.
  • pageSize(integer number, optional, default 20 max 50) - max number of results to return per call.
  • pageIndex(integer number, optional, default 1) - page index.

Returns

Object - An object with the following fields:
  • id(integer number) - JSON-RPC id.
  • jsonrpc(string) - JSON-RPC version.
  • result(object) - an object with the following fields:
    • nextPageIndex(integer number) - next page index.
    • total(integer number) - total auction records.
    • data(object array, defined below) - response datas.
  • Object schema:
    • contractAddress(string) - contract address.
    • tokenID(string) - id of the NFT.
    • from(hex string) - from address.
    • to(string) - to address.
    • amount(string) - the NFT transaction price with decimals.
    • originAmount(string) - the NFT transaction price without decimals.
    • currency(string) - currency for payment.
    • platform(string) - the NFT marketplace like OpenSea, LooksRare, Larvalabs.
    • txHash(hex string) - transaction hash.
    • timestamp(integer number) - timestamp in block.

Example

Request

curl https://api.blockvision.org/v1/<api key> \
-X POST \
-H "Content-Type: application/json" \
-d '{
"id": 1,
"jsonrpc": "2.0",
"method": "nft_collectionAuctionRecords",
"params": {
"contractAddress": "0x8a90CAb2b38dba80c64b7734e58Ee1dB38B8992e",
"pageSize": 5,
"pageIndex": 1
}
}'

Result

{
"jsonrpc": "2.0",
"id": 1,
"result": {
"data": [
{
"contractAddress": "0x8a90CAb2b38dba80c64b7734e58Ee1dB38B8992e",
"tokenID": "2804",
"amount": "15500000000000000000",
"originAmount": "15.5",
"currency": "ETH",
"from": "0xEE57a6C7ed5CEB919E6dC6998AF553c21489a353",
"to": "0x6fC9f86809Cb80CCc3B2959CA036B20eF56a1319",
"txHash": "0xf775691d54b880659c3743efb0a0598444af4e6f790a1af413124260f79e2f9f",
"platform": "OpenSea",
"timestamp": 1649575492
},
{
"contractAddress": "0x8a90CAb2b38dba80c64b7734e58Ee1dB38B8992e",
"tokenID": "7999",
"amount": "15490000000000000000",
"originAmount": "15.49",
"currency": "ETH",
"from": "0xcd53Bf47C97555976F34D992Be23F41877916f16",
"to": "0x87a10cC29bfaFD97a5ee4607A71dD7fb43bAc265",
"txHash": "0x7370be22fc60ffffd341bba537ad56df3ad60b00cc885547f88676a53cf15ffd",
"platform": "OpenSea",
"timestamp": 1649571325
},
{
"contractAddress": "0x8a90CAb2b38dba80c64b7734e58Ee1dB38B8992e",
"tokenID": "3800",
"amount": "15500000000000000000",
"originAmount": "15.5",
"currency": "ETH",
"from": "0xEE57a6C7ed5CEB919E6dC6998AF553c21489a353",
"to": "0x100Bdc7550FAF97E12EA838dC85F5c36C3C30fa3",
"txHash": "0x77d91d696db2e0332d41080695c2181c83b2b66ae75b4b9fc3be15afa39fb3fc",
"platform": "OpenSea",
"timestamp": 1649568004
},
{
"contractAddress": "0x8a90CAb2b38dba80c64b7734e58Ee1dB38B8992e",
"tokenID": "4667",
"amount": "15000000000000000000",
"originAmount": "15",
"currency": "ETH",
"from": "0xc56334C9c54D06Dc73aD5576EA8A22c90806af8a",
"to": "0xf981310d22A9f54E2449CDA8c8F48b0f88923843",
"txHash": "0xd8c55c71b13780dab65f354a4d5d70c79c207a093fa6419adcc31d374e5b1c0c",
"platform": "OpenSea",
"timestamp": 1649566323
},
{
"contractAddress": "0x8a90CAb2b38dba80c64b7734e58Ee1dB38B8992e",
"tokenID": "3128",
"amount": "16000000000000000000",
"originAmount": "16",
"currency": "ETH",
"from": "0x5030Af6967dF26a2bd7788B1D830C952E8AE66E4",
"to": "0x962871224822525C963D2d397B728A2aEaD83A1b",
"txHash": "0xe8195f6002a923c5f92415bc0fb6982dd4d98855dd53f42025a1c91e2a583c11",
"platform": "OpenSea",
"timestamp": 1649564729
}
],
"nextPageIndex": 2,
"total": 21181
}
}
Copy link
Outline
Parameters
Returns
Example
Request
Result