Get NFT Owners By Token ID

Query Template

Filtering Options

Parameter	Type	Description
where	object	특정 조건을 기준으로 결과를 필터링하는 객체.
limit	integer	반환할 최대 결과 수.
offset	integer	결과의 시작 위치를 지정.
order_by	object	결과를 정렬하는 기준을 지정하는 객체. 여러 필드를 기준으로 정렬할 수 있습니다.

Query Fields

Parameter	Type	Description
amount	integer	자산의 양.
is_fungible_v2	boolean	Fungible 여부 (v2).
is_soulbound_v2	boolean	Soulbound 여부 (v2).
last_transaction_timestamp	string	마지막 트랜잭션의 타임스탬프 (ISO 8601 형식).
non_transferrable_by_owner	boolean	소유자가 전송할 수 없는지 여부.
last_transaction_version	integer	마지막 트랜잭션의 버전.
owner_address	string	소유자의 주소.
property_version_v1	integer	속성 버전 (v1).
storage_id	string	저장소 ID.
table_type_v1	string	테이블 유형 (v1).
token_data_id	string	토큰 데이터 ID.
token_properties_mutated_v1	object	변형된 토큰 속성 (v1).
token_standard	string	토큰 표준.
current_token_data	object	현재 토큰 데이터.
current_token_data.collection_id	string	컬렉션 ID.
current_token_data.token_name	string	토큰 이름.
current_token_data.current_collection.creator_address	string	컬렉션 생성자의 주소.

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"
          }
        }
      }
    ]
  }
}