Links

nft_accountAuctionRecords

Gets the auction records for a given account address.
Through nft_accountAuctionRecords, you can fetch all auction records related to the account, accountAddress is necessary. If you specify the contract address, BlockVision will only return the auction records happening the specified collection. Using this API, you could clearly see the thorough auction records of certain account.
Supported on Ethereum and BNB Chain.

Parameters

Object - An object with the following fields (required):
  • accountAddress(hex string, required) - the account address you want to query.
  • contractAddress(hex string, optional) - 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.
    • total(integer number) - total auction records.
    • data(array of object, defined below) - response data.
  • Object schema:
    • action(string) - action sell/buy.
    • 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
TypeScript
curl https://api.blockvision.org/v1/<api key> \
-X POST \
-H "Content-Type: application/json" \
-d '{
"id": 1,
"jsonrpc": "2.0",
"method": "nft_accountAuctionRecords",
"params": {
"accountAddress": "0xEE57a6C7ed5CEB919E6dC6998AF553c21489a353",
"pageSize": 5,
"pageIndex": 1
}
}'
import { BlockVisionProvider, BvNetwork } from 'blockvision.js'
// Optional parameters, but default to eth-mainnet and default api-key.
const bv = new BlockVisionProvider(BvNetwork.ETH_MAINNET)
// Access the BlockVision NFT API
bv.getNFTAccountAuctionRecords({
accountAddress: '0xEE57a6C7ed5CEB919E6dC6998AF553c21489a353'
}).then(console.log)

Result

{
"jsonrpc": "2.0",
"id": 1,
"result": {
"data": [
{
"action": "buy",
"contractAddress": "0x4a8C9D751EEAbc5521A68FB080DD7E72E46462aF",
"tokenID": "7305",
"amount": "1169000000000000000",
"originAmount": "1.169",
"currency": "ETH",
"from": "0xF1a9F5AEb0F975489aC2628A22040Cf42E9fE8DD",
"to": "0xEE57a6C7ed5CEB919E6dC6998AF553c21489a353",
"txHash": "0xe23a7a050039d4f656177ea0424d0e7c447bb23ad8aa6ce3783980e62c08663c",
"platform": "OpenSea",
"timestamp": 1649578665
},
{
"action": "buy",
"contractAddress": "0x4a8C9D751EEAbc5521A68FB080DD7E72E46462aF",
"tokenID": "5266",
"amount": "1170000000000000000",
"originAmount": "1.17",
"currency": "ETH",
"from": "0x7BE93D4CebABDE8b2D5A2B841a423A478B22f469",
"to": "0xEE57a6C7ed5CEB919E6dC6998AF553c21489a353",
"txHash": "0xe23a7a050039d4f656177ea0424d0e7c447bb23ad8aa6ce3783980e62c08663c",
"platform": "OpenSea",
"timestamp": 1649578665
},
{
"action": "buy",
"contractAddress": "0x4a8C9D751EEAbc5521A68FB080DD7E72E46462aF",
"tokenID": "5751",
"amount": "1179900000000000000",
"originAmount": "1.1799",
"currency": "ETH",
"from": "0x25328855637D7454ec2a0a28B30943B93F82546a",
"to": "0xEE57a6C7ed5CEB919E6dC6998AF553c21489a353",
"txHash": "0xe23a7a050039d4f656177ea0424d0e7c447bb23ad8aa6ce3783980e62c08663c",
"platform": "OpenSea",
"timestamp": 1649578665
},
{
"action": "buy",
"contractAddress": "0x4a8C9D751EEAbc5521A68FB080DD7E72E46462aF",
"tokenID": "9754",
"amount": "1180000000000000000",
"originAmount": "1.18",
"currency": "ETH",
"from": "0x1cC3195C46C2F6AF665Ae281ad861eAb88ed8Fb5",
"to": "0xEE57a6C7ed5CEB919E6dC6998AF553c21489a353",
"txHash": "0xe23a7a050039d4f656177ea0424d0e7c447bb23ad8aa6ce3783980e62c08663c",
"platform": "OpenSea",
"timestamp": 1649578665
},
{
"action": "sell",
"contractAddress": "0x8a90CAb2b38dba80c64b7734e58Ee1dB38B8992e",
"tokenID": "2804",
"amount": "15500000000000000000",
"originAmount": "15.5",
"currency": "ETH",
"from": "0xEE57a6C7ed5CEB919E6dC6998AF553c21489a353",
"to": "0x6fC9f86809Cb80CCc3B2959CA036B20eF56a1319",
"txHash": "0xf775691d54b880659c3743efb0a0598444af4e6f790a1af413124260f79e2f9f",
"platform": "OpenSea",
"timestamp": 1649575492
}
],
"nextPageIndex": 2,
"total": 80
}
}