Get Owners by Token ID

This endpoint returns all Accounts that own a given NFT, identified by a collection contract address and token ID pair (supports pagination). Ownership and balances are only updated once the underlying transaction causing the change in ownership/balance is confirmed by the network (roughly ~10 minutes on all chains). Supported chains: ethereum, polygon, optimism, scroll, arbitrum, base, avalanche.

Looking for historical NFT data? Check out our historical_nft_balances_by_account and historical_nft_owners endpoints to query balance and ownership data at a particular timestamp.

Parameters

Parameter	Description	Type
chain_id	A keyword (i.e. "ethereum") or CAIP-2 identifier specifying the blockchain to query.	string
contract_address	required The contract address of the collection to retrieve owners for (supports ENS names).	string
token_id	required The token ID of the NFT to retrieve owners for.	integer
limit	The maximum number of results to retrieve (default 100).	string

PythonNodecURL

import requests url = "https://api.transpose.io/nft/owners-by-token-id" headers = { 'Content-Type': 'application/json', 'X-API-KEY': 'BtRVYj7dgnYUcr1gSSfWhmrTShIb8RBG', } params = { "chain_id": "ethereum", "contract_address": "0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB", "token_id": "5582", } response = requests.get(url, headers=headers, params=params) print(response.text) print('Credits charged:', response.headers.get('X-Credits-Charged', None))

const https = require('https'); const querystring = require('querystring'); const params = { chain_id: "ethereum", contract_address: "0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB", token_id: "5582", } var options = { hostname: 'api.transpose.io', path: '/nft/owners-by-token-id?' + querystring.stringify(params), method: 'GET', headers: { 'X-API-KEY': 'BtRVYj7dgnYUcr1gSSfWhmrTShIb8RBG' } }; var req = https.request(options, (res) => { console.log('Credits charged:', res.headers['x-credits-charged']); res.on('data', (d) => { process.stdout.write(d); }); }); req.on('error', (e) => { console.error(e); }); req.end();

curl -X GET \
    'https://api.transpose.io/nft/owners-by-token-id?chain_id=ethereum&contract_address=0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB&token_id=5582' \
    -H 'X-API-KEY: BtRVYj7dgnYUcr1gSSfWhmrTShIb8RBG' \

Got questions? Join our Discord

Discord is the primary home of the Transpose developer community. Join us to ask questions, share your work, and get help.