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

List wallets owning a specific NFT, defined by its contract and token ID.

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/0x524cab2ec69124574082676e6f654a18df49a048/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",
"rarity_rank": 21669,
"rarity_percentage": 98,
"rarity_label": "Top 98%",
"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",
"floor_price": "12345",
"floor_price_usd": "12345.4899",
"floor_price_currency": "eth",
"last_sale": {
"transaction_hash": "0x19e14f34b8f120c980f7ba05338d64c00384857fb9c561e2c56d0f575424a95c",
"block_timestamp": "2023-04-04T15:59:11.000Z",
"buyer_address": "0xcb1c1fde09f811b294172696404e88e658659905",
"seller_address": "0x497a7dee2f13db161eb2fec060fa783cb041419f",
"price": "7300000000000000",
"price_formatted": "0.0073",
"usd_price_at_sale": "13.61",
"current_usd_value": "15.53",
"token_address": "0xe8778996e096b39705c6a0a937eb587a1ebbda17",
"token_id": "170"
}
}
]
}