NFTs

Get one NFT's owner/holders

Get ownership for a specific NFT token ID by contract address. Returns the ERC-721 owner or the list of ERC-1155 token holders. Snapshot freshness: ownership comes from materialized snapshots that the data store refreshes every 5 minutes. The ERC-721 ownership snapshot only contains transfers older than head minus 256 blocks, so a newer ERC-721 transfer is not reflected yet; ERC-1155 balances are refreshed every 5 minutes without that cutoff. as_of_block here is the service's current indexed head, not the block height of the snapshot; read the snapshot time from meta.refreshed_at, and treat the data as stale when refreshed_at is null.

get/{chain}/nfts/{contract}/{token_id}

Request

  • Base URL: https://api.blockvectra.com/v1/data
  • URL: https://api.blockvectra.com/v1/data/{chain}/nfts/{contract}/{token_id}
  • Auth: API key in header x-api-key

Path parameters

chainstring required

Chain identifier: the chain value of an entry in GET /chains (for example robinhood_mainnet), which lists every value this API accepts, i.e. the exact lowercase form of that entry's chain_slug. Matching is exact and case-sensitive; other spellings, aliases and numeric chain IDs are not accepted and return 404 not_found (unknown or not-public chain). What the chain serves differs per chain: see that entry's features and coverage.

contractstring required

20-byte address. 0x/0X prefix optional; either hex digit case is accepted.

Example:0xAbCdEf0123456789aBcDeF0123456789aBCDEF01

20-byte contract address, 0x optional, either case.

token_idstring required

Decimal (base-10) integer string, must fit in UInt256. Empty, non-decimal, or out-of-range values are 400.

Response

The ERC-721 owner or ERC-1155 holder list for this (contract, token_id).

Example response

{
  "data": {
    "token_id": "9007199254740993",
    "block_timestamp": "2026-09-26T05:41:07Z"
  },
  "meta": {
    "chain": "robinhood_mainnet",
    "chain_slug": "ROBINHOOD_MAINNET",
    "chain_external_id": "eip155:4663",
    "refreshed_at": "2026-09-26T05:41:07Z"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.