Get NFT Owners By Token ID

---

Query Template

Filtering Options

Parameter	Type	Description
where	object	An object that filters results based on specific conditions.
limit	integer	The maximum number of results to return.
offset	integer	Specifies the starting position of the results.
order_by	object	An object that specifies the sorting criteria for the results. Multiple fields can be used for sorting.

Query Fields

Parameter	Type	Description
amount	integer	The amount of the asset.
is_fungible_v2	boolean	Whether the token is fungible (v2).
is_soulbound_v2	boolean	Whether the token is soulbound (v2).
last_transaction_timestamp	string	The timestamp of the last transaction (ISO 8601 format).
non_transferrable_by_owner	boolean	Whether the token cannot be transferred by the owner.
last_transaction_version	integer	The version of the last transaction.
owner_address	string	The address of the owner.
property_version_v1	integer	The property version (v1).
storage_id	string	The storage ID.
table_type_v1	string	The table type (v1).
token_data_id	string	The token data ID.
token_properties_mutated_v1	object	The mutated token properties (v1).
token_standard	string	The token standard.
current_token_data	object	The current token data.
current_token_data.collection_id	string	The collection ID.
current_token_data.token_name	string	The token name.
current_token_data.current_collection.creator_address	string	The address of the collection creator.

Example

Request Example

query MyQuery {
  current_token_ownerships_v2(
    limit: 5
    offset: 0
    order_by: {last_transaction_timestamp: desc}
    where: {
      token_data_id: {
        _eq: "0x9a47523002a8940afaae60cb01d13ccea0408b17e958ebf1940a9f687785d6da"
      }
    }
  ) {
    amount
    is_fungible_v2
    is_soulbound_v2
    last_transaction_timestamp
    non_transferrable_by_owner
    last_transaction_version
    owner_address
    property_version_v1
    storage_id
    table_type_v1
    token_data_id
    token_properties_mutated_v1
    token_standard
    current_token_data {
      collection_id
      token_name
      current_collection {
        creator_address
      }
    }
  }
}

Response Example

{
  "data": {
    "current_token_ownerships_v2": [
      {
        "amount": 1,
        "is_fungible_v2": null,
        "is_soulbound_v2": null,
        "last_transaction_timestamp": "2024-07-08T09:48:22.938911",
        "non_transferrable_by_owner": null,
        "last_transaction_version": 1019994299,
        "owner_address": "0x67dbec453adfb79e0a7585bde660ed696f611e9f621850bef926a6609d0701db",
        "property_version_v1": 0,
        "storage_id": "0x1535e5735d83b57e52e0d2a82896051344d831e9c27247c53a3c9a6a35838521",
        "table_type_v1": "0x3::token::TokenStore",
        "token_data_id": "0x9a47523002a8940afaae60cb01d13ccea0408b17e958ebf1940a9f687785d6da",
        "token_properties_mutated_v1": {},
        "token_standard": "v1",
        "current_token_data": {
          "collection_id": "0x7ac8cecb76edbbd5da40d719bbb9795fc5744e4098ee0ce1be4bb86c90f42301",
          "token_name": "AptosMonkeys #14",
          "current_collection": {
            "creator_address": "0xf932dcb9835e681b21d2f411ef99f4f5e577e6ac299eebee2272a39fb348f702"
          }
        }
      },
      {
        "amount": 0,
        "is_fungible_v2": null,
        "is_soulbound_v2": null,
        "last_transaction_timestamp": "2024-07-08T09:48:22.938911",
        "non_transferrable_by_owner": null,
        "last_transaction_version": 1019994299,
        "owner_address": "0x7b3326b15944d40740f1a7543e880e9bef1c1553510a9b7021e7933f1019c841",
        "property_version_v1": 0,
        "storage_id": "0x663e6fbfa04cb469471db3feed799d61a9a189302160518f466e2e4192861594",
        "table_type_v1": "0x3::token::TokenStore",
        "token_data_id": "0x9a47523002a8940afaae60cb01d13ccea0408b17e958ebf1940a9f687785d6da",
        "token_properties_mutated_v1": {},
        "token_standard": "v1",
        "current_token_data": {
          "collection_id": "0x7ac8cecb76edbbd5da40d719bbb9795fc5744e4098ee0ce1be4bb86c90f42301",
          "token_name": "AptosMonkeys #14",
          "current_collection": {
            "creator_address": "0xf932dcb9835e681b21d2f411ef99f4f5e577e6ac299eebee2272a39fb348f702"
          }
        }
      },
      {
        "amount": 0,
        "is_fungible_v2": null,
        "is_soulbound_v2": null,
        "last_transaction_timestamp": "2022-10-25T18:01:27.683764",
        "non_transferrable_by_owner": null,
        "last_transaction_version": 12599694,
        "owner_address": "0x00026a352311909bb553cbdaf21623d3a5164ab014a206176f5c67d8ef7d0d01",
        "property_version_v1": 0,
        "storage_id": "0x28eaee9c917297c81ccb64c15e01ac0faa843e4951253b6e4a33b0693e288eb0",
        "table_type_v1": "0x3::token::TokenStore",
        "token_data_id": "0x9a47523002a8940afaae60cb01d13ccea0408b17e958ebf1940a9f687785d6da",
        "token_properties_mutated_v1": {},
        "token_standard": "v1",
        "current_token_data": {
          "collection_id": "0x7ac8cecb76edbbd5da40d719bbb9795fc5744e4098ee0ce1be4bb86c90f42301",
          "token_name": "AptosMonkeys #14",
          "current_collection": {
            "creator_address": "0xf932dcb9835e681b21d2f411ef99f4f5e577e6ac299eebee2272a39fb348f702"
          }
        }
      }
    ]
  }
}