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