nft_owners
Quickly query the current or previous owner of any NFT.
You can specify the contract address and certain ID of the NFT, then you can obtain the data of current and historical owner of that NFT. Using this API, some airdrops and marketing strategies could be made according to this returning stats. Plus, you could see which account keeps holding this NFT.
Supported on Ethereum, BNB Chain, Optimism, and Arbitrum.

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.
  • tokenId(string, required) - id of the NFT.

Returns

Object - An object with the following fields:
  • Response Payload:
    • id(integer number) - JSON-RPC id.
    • jsonrpc(string) - JSON-RPC version.
    • result(object) - an object with the following fields:
      • data(object array, defined below) - response datas.
  • Object schema:
    • owner(string) - owner account address.
    • timestamp(integer number) - the unix timestamp like 1646943803.
    • date(string) - the UTC date string like 2022-03-10 20:23:23.
    • blockNumber(integer number) - block number.

Example

Request

curl https://api.blockvision.org/v1/<api key> \
-X POST \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 0,
"method": "nft_owners",
"params": {
"contractAddress": "0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB",
"tokenId": "5822"
}
}'

Result

{
"jsonrpc": "2.0",
"id": 0,
"result": {
"data": [
{
"owner": "0x7DDFFbc38121a7b21AA4B0bc96318E86EF2D0cb7",
"timestamp": 1646943803,
"date": "2022-03-10 20:23:23",
"blockNumber": 14361235
},
{
"owner": "0x7Eb28B2f14A59789ec4c782A5DD957F9C8F33f6b",
"timestamp": 1613938992,
"date": "2021-02-21 20:23:12",
"blockNumber": 11902448
},
{
"owner": "0x1e32a859d69dde58d03820F8f138C99B688D132F",
"timestamp": 1498236982,
"date": "2017-06-23 16:56:22",
"blockNumber": 3918882
}
]
}
}
Copy link
Outline
Parameters
Returns
Example
Request
Result