Skip to main content
GET
/
nft
/
owners
/
nft
cURL
curl --request GET \
  --url https://api.uniblock.dev/uni/v1/nft/owners/nft \
  --header 'X-API-KEY: <api-key>'
{
  "owners": [
    {
      "ownerAddress": "0x18a808dd312736fc75eb967fc61990af726f04e4",
      "quantity": "18",
      "acquiredDate": "2022-05-10T02:22:25Z"
    }
  ],
  "cursor": "ALC_MHgyMzEyZjAwMTQ5ZDAxMDgwNmQ5ZWY2ZjNlYTMyMGViMWUxYTZiYzhlOjB4MDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDFhYTpmYWxzZQ=="
}

Authorizations

​
X-API-KEY
string
header
required

API key to access the API (Optional)

Query Parameters

​
chainId
enum<string>
default:1
required

Unique identifier for a blockchain network.

Available options:
1,
10,
10143,
10218,
11011,
11124,
11142220,
11155111,
11155420,
11155931,
1284,
130,
1301,
1315,
1328,
1329,
137,
143,
146,
14601,
1514,
168587773,
1868,
1946,
2021,
2030232745,
204,
232,
2442,
252,
2522,
2741,
30,
300,
31,
324,
33111,
33139,
34443,
351243127,
360,
3636,
3637,
36900,
37111,
4157,
4158,
42161,
421614,
42170,
42220,
43113,
43114,
44787,
480,
4801,
5000,
5003,
510,
5115,
5330,
53302,
534351,
534352,
5371,
5373,
545,
560048,
5611,
57054,
57073,
59141,
59144,
60808,
613419,
666666666,
685685,
6900,
69000,
6985385,
7001,
7080969,
747,
763373,
7777777,
80002,
80069,
80094,
808813,
81457,
843843,
8453,
84532,
869,
919,
9745,
9746,
994873017,
998,
999,
999999999,
aptos,
bitcoin,
bitcoin-testnet,
eth-holesky-beacon,
eth-hoodi-beacon,
eth-mainnet-beacon,
eth-sepolia-beacon,
starknet,
starknet-sepolia,
sui
Example:

1

​
contractAddress
string
default:0x81Ae0bE3A8044772D04F32398bac1E1B4B215aa8
required

The address of the NFT collection to query.

Example:

"0x81Ae0bE3A8044772D04F32398bac1E1B4B215aa8"

​
tokenId
string
default:1
required

The ID of the token.

Example:

"1"

​
cursor
string

Cursor from previous query to get next page of results.

​
includeRaw
boolean

Returns the raw data given by the provider. WARNING: removes backup feature, and raw data returned is not normalized which might make switching providers difficult

Example:

null

​
provider
enum<string>

Specify which provider to use. The project's provider priority list is used by default if no providers are selected. (Priority list can be managed on Uniblock's dashboard)

Available options:
Alchemy,

Response

200 - application/json
​
owners
object[]
required
​
cursor
string
required
Example:

"ALC_MHgyMzEyZjAwMTQ5ZDAxMDgwNmQ5ZWY2ZjNlYTMyMGViMWUxYTZiYzhlOjB4MDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDFhYTpmYWxzZQ=="