Get NFT Transfers By Account

Query Template

Filtering Options

ParameterTypeDescription
whereobject특정 조건을 기준으로 결과를 필터링하는 객체.
limitinteger반환할 최대 결과 수.
offsetinteger결과의 시작 위치를 지정.
order_byobject결과를 정렬하는 기준을 지정하는 객체. 여러 필드를 기준으로 정렬할 수 있습니다.

Query Fields

ParameterTypeDescription
transaction_versioninteger트랜잭션의 버전.
typestring이벤트 유형.
transaction_timestampstring트랜잭션의 타임스탬프 (ISO 8601 형식).
token_standardstring토큰 표준.
token_data_idstring토큰 데이터 ID.
token_amountinteger토큰 양.
to_addressstring수신 주소.
from_addressstring발신 주소.
event_indexinteger이벤트 인덱스.
event_account_addressstring이벤트 계정 주소.
entry_function_id_strstring엔트리 함수 ID 문자열.
before_valuestring변경 전 값.
is_fungible_v2booleanFungible 여부 (v2).
property_version_v1integer속성 버전 (v1).
after_valuestring변경 후 값.
current_token_dataobject현재 토큰 데이터.
current_token_data.collection_idstring컬렉션 ID.
current_token_data.decimalsinteger소수점 이하 자리 수.
current_token_data.descriptionstring설명.
current_token_data.is_deleted_v2boolean삭제 여부 (v2).
current_token_data.is_fungible_v2booleanFungible 여부 (v2).
current_token_data.largest_property_version_v1integer최대 속성 버전 (v1).
current_token_data.last_transaction_versioninteger마지막 트랜잭션 버전.
current_token_data.token_data_idstring토큰 데이터 ID.
current_token_data.token_namestring토큰 이름.
current_token_data.token_standardstring토큰 표준.
current_token_data.token_uristring토큰 URI.
current_token_data.token_propertiesobject토큰 속성.
current_token_data.supplyinteger공급량.
current_token_data.maximuminteger최대량.
current_token_data.last_transaction_timestampstring마지막 트랜잭션 타임스탬프 (ISO 8601 형식).

Example

Request Example

query MyQuery {
  token_activities_v2(
    limit: 5
    offset: 0
    where: {
      event_account_address: {
        _eq: "0x274c398a921b8e2ba345feac3039e1c8b196a7eb1395cdd3584af3a85eb9ec50"
      }
    }
    order_by: { transaction_version: desc, event_index: desc }
  ) {
    transaction_version
    type
    transaction_timestamp
    token_standard
    token_data_id
    token_amount
    to_address
    from_address
    event_index
    event_account_address
    entry_function_id_str
    before_value
    is_fungible_v2
    property_version_v1
    after_value
    current_token_data {
      collection_id
      decimals
      description
      is_deleted_v2
      is_fungible_v2
      largest_property_version_v1
      last_transaction_version
      token_data_id
      token_name
      token_standard
      token_uri
      token_properties
      supply
      maximum
      last_transaction_timestamp
    }
  }
}

Response Example

{
  "data": {
    "token_activities_v2": [
      {
        "transaction_version": 108478769,
        "type": "0x3::token_transfers::TokenClaimEvent",
        "transaction_timestamp": "2023-03-26T21:48:41.317738",
        "token_standard": "v1",
        "token_data_id": "0x1eb27f897040b5ae8cf236591354658a2044703bf46307687f916651ca317bda",
        "token_amount": 1,
        "to_address": "0xfd55b452c755d56c12860a760f61eb9d8edd46677b8fa59eee905989049620a9",
        "from_address": "0x274c398a921b8e2ba345feac3039e1c8b196a7eb1395cdd3584af3a85eb9ec50",
        "event_index": 1,
        "event_account_address": "0x274c398a921b8e2ba345feac3039e1c8b196a7eb1395cdd3584af3a85eb9ec50",
        "entry_function_id_str": "0x3::token_transfers::claim_script",
        "before_value": null,
        "is_fungible_v2": null,
        "property_version_v1": 0,
        "after_value": null,
        "current_token_data": {
          "collection_id": "0x92c681b47797568f7513421a7cc1d47d349a71af66cd91794844543ff5430c67",
          "decimals": 0,
          "description": "AptosWizards early NFT Collection on Aptos Ecosystem. Do magic with your Wizard, meet people, staking, Early DAO on Aptos.",
          "is_deleted_v2": null,
          "is_fungible_v2": null,
          "largest_property_version_v1": 0,
          "last_transaction_version": 9618661,
          "token_data_id": "0x1eb27f897040b5ae8cf236591354658a2044703bf46307687f916651ca317bda",
          "token_name": "Aptos Wizards #4221",
          "token_standard": "v1",
          "token_uri": "https://ipfs.bluemove.io/uploads/AptosWizards/metadata/4221.json",
          "token_properties": {},
          "supply": 1,
          "maximum": 1,
          "last_transaction_timestamp": "2022-10-23T16:00:26.82932"
        }
      },
      {
        "transaction_version": 108478394,
        "type": "0x3::token::WithdrawEvent",
        "transaction_timestamp": "2023-03-26T21:47:45.071111",
        "token_standard": "v1",
        "token_data_id": "0x1eb27f897040b5ae8cf236591354658a2044703bf46307687f916651ca317bda",
        "token_amount": 1,
        "to_address": null,
        "from_address": "0x274c398a921b8e2ba345feac3039e1c8b196a7eb1395cdd3584af3a85eb9ec50",
        "event_index": 0,
        "event_account_address": "0x274c398a921b8e2ba345feac3039e1c8b196a7eb1395cdd3584af3a85eb9ec50",
        "entry_function_id_str": "0x3::token_transfers::offer_script",
        "before_value": null,
        "is_fungible_v2": null,
        "property_version_v1": 0,
        "after_value": null,
        "current_token_data": {
          "collection_id": "0x92c681b47797568f7513421a7cc1d47d349a71af66cd91794844543ff5430c67",
          "decimals": 0,
          "description": "AptosWizards early NFT Collection on Aptos Ecosystem. Do magic with your Wizard, meet people, staking, Early DAO on Aptos.",
          "is_deleted_v2": null,
          "is_fungible_v2": null,
          "largest_property_version_v1": 0,
          "last_transaction_version": 9618661,
          "token_data_id": "0x1eb27f897040b5ae8cf236591354658a2044703bf46307687f916651ca317bda",
          "token_name": "Aptos Wizards #4221",
          "token_standard": "v1",
          "token_uri": "https://ipfs.bluemove.io/uploads/AptosWizards/metadata/4221.json",
          "token_properties": {},
          "supply": 1,
          "maximum": 1,
          "last_transaction_timestamp": "2022-10-23T16:00:26.82932"
        }
      },
      {
        "transaction_version": 108478394,
        "type": "0x3::token_transfers::TokenOfferEvent",
        "transaction_timestamp": "2023-03-26T21:47:45.071111",
        "token_standard": "v1",
        "token_data_id": "0x1eb27f897040b5ae8cf236591354658a2044703bf46307687f916651ca317bda",
        "token_amount": 1,
        "to_address": "0xfd55b452c755d56c12860a760f61eb9d8edd46677b8fa59eee905989049620a9",
        "from_address": "0x274c398a921b8e2ba345feac3039e1c8b196a7eb1395cdd3584af3a85eb9ec50",
        "event_index": 1,
        "event_account_address": "0x274c398a921b8e2ba345feac3039e1c8b196a7eb1395cdd3584af3a85eb9ec50",
        "entry_function_id_str": "0x3::token_transfers::offer_script",
        "before_value": null,
        "is_fungible_v2": null,
        "property_version_v1": 0,
        "after_value": null,
        "current_token_data": {
          "collection_id": "0x92c681b47797568f7513421a7cc1d47d349a71af66cd91794844543ff5430c67",
          "decimals": 0,
          "description": "AptosWizards early NFT Collection on Aptos Ecosystem. Do magic with your Wizard, meet people, staking, Early DAO on Aptos.",
          "is_deleted_v2": null,
          "is_fungible_v2": null,
          "largest_property_version_v1": 0,
          "last_transaction_version": 9618661,
          "token_data_id": "0x1eb27f897040b5ae8cf236591354658a2044703bf46307687f916651ca317bda",
          "token_name": "Aptos Wizards #4221",
          "token_standard": "v1",
          "token_uri": "https://ipfs.bluemove.io/uploads/AptosWizards/metadata/4221.json",
          "token_properties": {},
          "supply": 1,
          "maximum": 1,
          "last_transaction_timestamp": "2022-10-23T16:00:26.82932"
        }
      },
      {
        "transaction_version": 102297836,
        "type": "0x3::token::MutateTokenPropertyMapEvent",
        "transaction_timestamp": "2023-03-15T09:48:18.025766",
        "token_standard": "v1",
        "token_data_id": "0xfc09b54d859a56b4d33d169f845e03429c4484afffe0dc85cad0601cf50fc9a2",
        "token_amount": 0,
        "to_address": null,
        "from_address": "0x274c398a921b8e2ba345feac3039e1c8b196a7eb1395cdd3584af3a85eb9ec50",
        "event_index": 12,
        "event_account_address": "0x274c398a921b8e2ba345feac3039e1c8b196a7eb1395cdd3584af3a85eb9ec50",
        "entry_function_id_str": "0x867ed1f6bf916171b1de3ee92849b8978b7d1b9e0a8cc982a3d19d535dfd9c0c::domains::register_domain_with_signature",
        "before_value": null,
        "is_fungible_v2": null,
        "property_version_v1": 1,
        "after_value": null,
        "current_token_data": {
          "collection_id": "0x09e63a48047b1c2bc51c0abc4b67ffcd9922e0adc99a6cc36532662172976a4b",
          "decimals": 0,
          "description": "This is an official Aptos Labs Name Service Name",
          "is_deleted_v2": null,
          "is_fungible_v2": null,
          "largest_property_version_v1": 1,
          "last_transaction_version": 102297836,
          "token_data_id": "0xfc09b54d859a56b4d33d169f845e03429c4484afffe0dc85cad0601cf50fc9a2",
          "token_name": "reuben.apt",
          "token_standard": "v1",
          "token_uri": "https://www.aptosnames.com/api/mainnet/v1/metadata/reuben.apt",
          "token_properties": {
            "type": "domain",
            "creation_time_sec": "1678873698"
          },
          "supply": 0,
          "maximum": 0,
          "last_transaction_timestamp": "2023-03-15T09:48:18.025766"
        }
      },
      {
        "transaction_version": 102297836,
        "type": "0x3::token::DepositEvent",
        "transaction_timestamp": "2023-03-15T09:48:18.025766",
        "token_standard": "v1",
        "token_data_id": "0xfc09b54d859a56b4d33d169f845e03429c4484afffe0dc85cad0601cf50fc9a2",
        "token_amount": 1,
        "to_address": "0x274c398a921b8e2ba345feac3039e1c8b196a7eb1395cdd3584af3a85eb9ec50",
        "from_address": null,
        "event_index": 10,
        "event_account_address": "0x274c398a921b8e2ba345feac3039e1c8b196a7eb1395cdd3584af3a85eb9ec50",
        "entry_function_id_str": "0x867ed1f6bf916171b1de3ee92849b8978b7d1b9e0a8cc982a3d19d535dfd9c0c::domains::register_domain_with_signature",
        "before_value": null,
        "is_fungible_v2": null,
        "property_version_v1": 1,
        "after_value": null,
        "current_token_data": {
          "collection_id": "0x09e63a48047b1c2bc51c0abc4b67ffcd9922e0adc99a6cc36532662172976a4b",
          "decimals": 0,
          "description": "This is an official Aptos Labs Name Service Name",
          "is_deleted_v2": null,
          "is_fungible_v2": null,
          "largest_property_version_v1": 1,
          "last_transaction_version": 102297836,
          "token_data_id": "0xfc09b54d859a56b4d33d169f845e03429c4484afffe0dc85cad0601cf50fc9a2",
          "token_name": "reuben.apt",
          "token_standard": "v1",
          "token_uri": "https://www.aptosnames.com/api/mainnet/v1/metadata/reuben.apt",
          "token_properties": {
            "type": "domain",
            "creation_time_sec": "1678873698"
          },
          "supply": 0,
          "maximum": 0,
          "last_transaction_timestamp": "2023-03-15T09:48:18.025766"
        }
      }
    ]
  }
}