Get NFT Transfers By Account

Query Template

Filtering Options

Parameter	Type	Description
where	object	Object to filter results by specified conditions.
limit	integer	Maximum number of results to return.
offset	integer	Starting position for results.
order_by	object	Object specifying sort order. You can sort by multiple fields.

Query Fields

Parameter	Type	Description
transaction_version	integer	Transaction version.
type	string	Event type.
transaction_timestamp	string	Transaction timestamp (ISO 8601 format).
token_standard	string	Token standard.
token_data_id	string	Token data ID.
token_amount	integer	Token amount.
to_address	string	Recipient address.
from_address	string	Sender address.
event_index	integer	Event index.
event_account_address	string	Event account address.
entry_function_id_str	string	Entry function ID string.
before_value	string	Value before change.
is_fungible_v2	boolean	Whether fungible (v2).
property_version_v1	integer	Property version (v1).
after_value	string	Value after change.
current_token_data	object	Current token data.
current_token_data.collection_id	string	Collection ID.
current_token_data.decimals	integer	Number of decimal places.
current_token_data.description	string	Description.
current_token_data.is_deleted_v2	boolean	Whether deleted (v2).
current_token_data.is_fungible_v2	boolean	Whether fungible (v2).
current_token_data.largest_property_version_v1	integer	Largest property version (v1).
current_token_data.last_transaction_version	integer	Last transaction version.
current_token_data.token_data_id	string	Token data ID.
current_token_data.token_name	string	Token name.
current_token_data.token_standard	string	Token standard.
current_token_data.token_uri	string	Token URI.
current_token_data.token_properties	object	Token properties.
current_token_data.supply	integer	Supply.
current_token_data.maximum	integer	Maximum.
current_token_data.last_transaction_timestamp	string	Last transaction timestamp (ISO 8601 format).

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