Skip to main content

Don't have an API key yet?

Sign-up to Moralis to get your free API key and start building today.

Get Your Free API Key

Get NFT owners by token ID

GEThttps://deep-index.moralis.io/api/v2.2/nft/:address/:token_id/owners

Get owners of a specific NFT given the contract address and token ID.

  • Requests for contract addresses not yet indexed will automatically start the indexing process for that NFT collection
PATH PARAMS
addressstringrequired
The address of the NFT contract
token_idstringrequired
The ID of the token
QUERY PARAMS
chainstring
The chain to query
formatstring
The format of the token ID
limitnumber
The desired page size of the result.
cursorstring
The cursor returned in the previous response (used for getting the next page).
normalizeMetadataboolean
Should normalized metadata be returned?
media_itemsboolean
Should preview media data be returned?
Responses
200Returns a collection of NFTs with their respective owners.
400Bad Request
404Not Found
429Too Many Requests
500Internal Server Error
API KEY
curl --request GET \
--url 'https://deep-index.moralis.io/api/v2.2/nft/0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB/1/owners?chain=eth&format=decimal&limit=25' \
--header 'accept: application/json' \
--header 'X-API-Key: YOUR_API_KEY'
Response Example
{
"status": "SYNCING",
"page": "2",
"page_size": "100",
"cursor": "",
"result": {
"token_address": "0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB",
"token_id": "15",
"contract_type": "ERC721",
"owner_of": "0x057Ec652A4F150f7FF94f089A38008f49a0DF88e",
"block_number": "88256",
"block_number_minted": "88256",
"token_uri": "",
"metadata": "",
"normalized_metadata": "",
"media": "",
"amount": "1",
"name": "CryptoKitties",
"symbol": "RARI",
"token_hash": "502cee781b0fb40ea02508b21d319ced",
"last_token_uri_sync": "2021-02-24T00:47:26.647Z",
"last_metadata_sync": "2021-02-24T00:47:26.647Z",
"possible_spam": "false",
"verified_collection": "false",
"rarity_rank": 21669,
"rarity_label": "Top 98%",
"rarity_percentage": 98
}
}