Get total number of ownership transfers for a specific NFT

Retrieves the total number of transfers for a specific NFT instance. Useful for determining how frequently an NFT has changed hands.

GET /v2/tokens/{address_hash_param}/instances/{token_id_param}/transfers-count

Get total number of ownership transfers for a specific NFT

cURL

curl --request GET \
  --url http://localhost/api/v2/tokens/{address_hash_param}/instances/{token_id_param}/transfers-count

200

{
  "transfers_count": 123
}

Path Parameters

address_hash_param · string · required

Address hash in the path

Pattern: ^0x([A-Fa-f0-9]{40})$

token_id_param · string | null · required

Token ID for ERC-721/1155/404 tokens

Pattern: ^-?([1-9][0-9]*|0)$

Query Parameters

apikey · string

API key for rate limiting or for sensitive endpoints

key · string

Secret key for getting access to restricted resources

Response

200

application/json

Total number of transfers for the specified NFT instance.

transfers_count · integer