This query retrieves the NFT transaction activity, including both:
- Solana Internal Contract Activity – Transactions occurring within Solana's marketplace smart contracts.
- .External Transaction Activity – Transactions involving external wallets or platform ownership transactions with the NFT.
Sample query
query ($networkId: String!, $contractAddress: String!, $tokenId: BigInt!, $nftTokenId: UUID1, $filterBy: NFTTxEventType, $orgId: UUID1!, $ownerAddress: String, $limit: Int, $offset: Int, $currency: CurrencyCodeFiat) {
getNFTHistoryV2(
networkId: $networkId
contractAddress: $contractAddress
tokenId: $tokenId
nftTokenId: $nftTokenId
filterBy: $filterBy
orgId: $orgId
ownerAddress: $ownerAddress
offset: $offset
limit: $limit
currency: $currency
) {
totalCount
data {
blockNum
hash
from
to
value
tokenId
category
asset
price {
value
unit
type
__typename
}
blockTimestamp
eventType
fromUserAvatar
fromUserName
toUserAvatar
toUserName
erc1155Metadata {
tokenId
value
__typename
}
__typename
}
__typename
}
}
Sample variable
{
"nftTokenId": "021272bc-e41b-412f-8631-f63304a6d3a6",
"orgId": "0db10bbf-85fe-4c87-911b-d18f8568fc07",
"contractAddress": "FytWTAobotGfihugTU8TEQzEgjfrttUVNWcRHv1GG2G3",
"tokenId": "7dDe5D6N16tkuM53RKEuKJ7gZDiB7NC6oyQKP2AQJDSc",
"networkId": "51987430-77d2-4633-99c3-100cdd9952c7",
"ownerAddress": "7GckBHDKCMEdFdnxJV3qY12YCEVop6MKtgjVAnd7vHGD",
"limit": 10,
"offset": 0,
"currency": "USD"
}
Sample response
{
"data": {
"getNFTHistoryV2": {
"totalCount": 53,
"data": [
{
"blockNum": null,
"hash": "DkowJ1nZ7s9AYqKHQsF3QkZ5FyLb8BY85oRxp5MC5STeRhPC6nq1WehzVoX8T54cDxwg9prgVxzfczKg5P8X8av",
"from": "AhE1ubLPzT6vY1rWFoPko5DSC3rpQUhLMjdEiWV1mJGh",
"to": "7GckBHDKCMEdFdnxJV3qY12YCEVop6MKtgjVAnd7vHGD",
"value": null,
"tokenId": null,
"category": null,
"asset": null,
"price": [
{
"value": 0.037,
"unit": "USD",
"type": "FIAT",
"__typename": "NFTPrice"
},
{
"value": 1,
"unit": "VIN",
"type": "CRYPTO",
"__typename": "NFTPrice"
}
],
"blockTimestamp": "2025-01-20T12:21:55.730988Z",
"eventType": "Offer",
"fromUserAvatar": "",
"fromUserName": "",
"toUserAvatar": "",
"toUserName": "",
"erc1155Metadata": null,
"__typename": "NFTHistory"
},
{
"blockNum": null,
"hash": "5KDPuBLd2fVF74uKyfPMEuN79ZfUNnns44k249nhtNUf2eioQnsshnV1vfKhVX2PKdwQ6icwokvQZri7oyhT1nA8",
"from": "AhE1ubLPzT6vY1rWFoPko5DSC3rpQUhLMjdEiWV1mJGh",
"to": "7GckBHDKCMEdFdnxJV3qY12YCEVop6MKtgjVAnd7vHGD",
"value": null,
"tokenId": null,
"category": null,
"asset": null,
"price": [
{
"value": 0.037,
"unit": "USD",
"type": "FIAT",
"__typename": "NFTPrice"
},
{
"value": 1,
"unit": "VIN",
"type": "CRYPTO",
"__typename": "NFTPrice"
}
],
"blockTimestamp": "2025-01-20T12:03:40.954268Z",
"eventType": "Offer_Sold",
"fromUserAvatar": "",
"fromUserName": "",
"toUserAvatar": "",
"toUserName": "",
"erc1155Metadata": null,
"__typename": "NFTHistory"
},
{
"blockNum": null,
"hash": "5UgrfeuhQBRMBEJffPkVLjm5MeShG6g6C8m2wNjuJwbGXFiUMDSxmUtsuc8eKx64Vfw33o3to8vHNJyFf3mDQ3BW",
"from": "7GckBHDKCMEdFdnxJV3qY12YCEVop6MKtgjVAnd7vHGD",
"to": "AhE1ubLPzT6vY1rWFoPko5DSC3rpQUhLMjdEiWV1mJGh",
"value": null,
"tokenId": null,
"category": null,
"asset": null,
"price": [
{
"value": 0.037,
"unit": "USD",
"type": "FIAT",
"__typename": "NFTPrice"
},
{
"value": 1,
"unit": "VIN",
"type": "CRYPTO",
"__typename": "NFTPrice"
}
],
"blockTimestamp": "2025-01-20T11:55:36.759982Z",
"eventType": "Offer",
"fromUserAvatar": "",
"fromUserName": "",
"toUserAvatar": "",
"toUserName": "",
"erc1155Metadata": null,
"__typename": "NFTHistory"
},
{
"blockNum": null,
"hash": "uh59p5YRE5Krq6uQTUJ4A4FaAymDmGgWt2pLz3EctgiSpZyYBSNhLhuAUyDAuZ58dxWtgWDZS4sE5iDu4NRgP37",
"from": "7GckBHDKCMEdFdnxJV3qY12YCEVop6MKtgjVAnd7vHGD",
"to": "AhE1ubLPzT6vY1rWFoPko5DSC3rpQUhLMjdEiWV1mJGh",
"value": null,
"tokenId": null,
"category": null,
"asset": null,
"price": [
{
"value": 0.037,
"unit": "USD",
"type": "FIAT",
"__typename": "NFTPrice"
},
{
"value": 1,
"unit": "VIN",
"type": "CRYPTO",
"__typename": "NFTPrice"
}
],
"blockTimestamp": "2025-01-20T11:35:21.518644Z",
"eventType": "Sale",
"fromUserAvatar": "",
"fromUserName": "",
"toUserAvatar": "",
"toUserName": "",
"erc1155Metadata": null,
"__typename": "NFTHistory"
},
{
"blockNum": null,
"hash": "4mqSCBdFuboXyk4oHJuKoMqvdLiNtDtvsoRp2GsQkN1rZBZV2a16x7Fbwh7HJeGy7L7st6xbQoXuXNUnSduWAzyX",
"from": "AhE1ubLPzT6vY1rWFoPko5DSC3rpQUhLMjdEiWV1mJGh",
"to": "7GckBHDKCMEdFdnxJV3qY12YCEVop6MKtgjVAnd7vHGD",
"value": null,
"tokenId": null,
"category": null,
"asset": null,
"price": [
{
"value": 0.037,
"unit": "USD",
"type": "FIAT",
"__typename": "NFTPrice"
},
{
"value": 1,
"unit": "VIN",
"type": "CRYPTO",
"__typename": "NFTPrice"
}
],
"blockTimestamp": "2025-01-20T11:18:17.280547Z",
"eventType": "Offer_Cancelled",
"fromUserAvatar": "",
"fromUserName": "",
"toUserAvatar": "",
"toUserName": "",
"erc1155Metadata": null,
"__typename": "NFTHistory"
},
{
"blockNum": null,
"hash": "58FiaAUqqLJdjb2Q4Pd1u9eS1GVZTr6cVTgALNnpArkYuH4WnmpWDKAhjTQGvP45p54rJpoQYH2SnuKXj64zatJm",
"from": "AhE1ubLPzT6vY1rWFoPko5DSC3rpQUhLMjdEiWV1mJGh",
"to": "7GckBHDKCMEdFdnxJV3qY12YCEVop6MKtgjVAnd7vHGD",
"value": null,
"tokenId": null,
"category": null,
"asset": null,
"price": [
{
"value": 0.037,
"unit": "USD",
"type": "FIAT",
"__typename": "NFTPrice"
},
{
"value": 1,
"unit": "VIN",
"type": "CRYPTO",
"__typename": "NFTPrice"
}
],
"blockTimestamp": "2025-01-20T10:41:08.259006Z",
"eventType": "Offer",
"fromUserAvatar": "",
"fromUserName": "",
"toUserAvatar": "",
"toUserName": "",
"erc1155Metadata": null,
"__typename": "NFTHistory"
},
{
"blockNum": null,
"hash": "5buz7pUmsjNi8z1iDEuJJCDeMRAicsvqnEak8UNeMj9yLDTiKkek56r7dDJCJUpmtUDifueL6tvA8BNuKBQq9M5k",
"from": "7GckBHDKCMEdFdnxJV3qY12YCEVop6MKtgjVAnd7vHGD",
"to": "",
"value": null,
"tokenId": null,
"category": null,
"asset": null,
"price": [
{
"value": 0.0355,
"unit": "USD",
"type": "FIAT",
"__typename": "NFTPrice"
},
{
"value": 1,
"unit": "VIN",
"type": "CRYPTO",
"__typename": "NFTPrice"
}
],
"blockTimestamp": "2025-01-17T19:43:57.899708Z",
"eventType": "List",
"fromUserAvatar": "",
"fromUserName": "",
"toUserAvatar": "",
"toUserName": "",
"erc1155Metadata": null,
"__typename": "NFTHistory"
},
{
"blockNum": null,
"hash": "23JoTK2jBKadJHArQQSdcyVN7hr6NDqjHXEp7qJjakYFMRSQQBuVWd6LTytiX3zqZNyguTSU9dXhF13uCp7CcJoD",
"from": "7GckBHDKCMEdFdnxJV3qY12YCEVop6MKtgjVAnd7vHGD",
"to": "",
"value": null,
"tokenId": null,
"category": null,
"asset": null,
"price": [
{
"value": 0.0355,
"unit": "USD",
"type": "FIAT",
"__typename": "NFTPrice"
},
{
"value": 1,
"unit": "VIN",
"type": "CRYPTO",
"__typename": "NFTPrice"
}
],
"blockTimestamp": "2025-01-17T19:27:16.618161Z",
"eventType": "List_Removed",
"fromUserAvatar": "",
"fromUserName": "",
"toUserAvatar": "",
"toUserName": "",
"erc1155Metadata": null,
"__typename": "NFTHistory"
},
{
"blockNum": null,
"hash": "651aLHfQAJ1qdmiFfz15H3enVZdySGrF9cs7kVbjrWNTivFAr1mLp5vjjnXzNNn2iYEUoztqg7u6iWqyhGj7FbCw",
"from": "7GckBHDKCMEdFdnxJV3qY12YCEVop6MKtgjVAnd7vHGD",
"to": "",
"value": null,
"tokenId": null,
"category": null,
"asset": null,
"price": [
{
"value": 0.0336,
"unit": "USD",
"type": "FIAT",
"__typename": "NFTPrice"
},
{
"value": 1,
"unit": "VIN",
"type": "CRYPTO",
"__typename": "NFTPrice"
}
],
"blockTimestamp": "2025-01-17T14:52:01.142324Z",
"eventType": "List",
"fromUserAvatar": "",
"fromUserName": "",
"toUserAvatar": "",
"toUserName": "",
"erc1155Metadata": null,
"__typename": "NFTHistory"
},
{
"blockNum": null,
"hash": "62JrTc4xwcynC8QJX1Gpt2wHBmj2U9vLvacmbwMEkKd1h2bnLaCxEC5H25zzkwgAmSmCW96e5XW6vpyNkQuG2WhE",
"from": "HHC7mBcHwUAJXufKFCaXJJDoJNwvRp1vfuqVW4NxpHq9",
"to": "7GckBHDKCMEdFdnxJV3qY12YCEVop6MKtgjVAnd7vHGD",
"value": null,
"tokenId": null,
"category": null,
"asset": null,
"price": [
{
"value": 0.0403,
"unit": "USD",
"type": "FIAT",
"__typename": "NFTPrice"
},
{
"value": 1,
"unit": "VIN",
"type": "CRYPTO",
"__typename": "NFTPrice"
}
],
"blockTimestamp": "2024-12-31T01:47:37.419885Z",
"eventType": "Offer_Cancelled",
"fromUserAvatar": "",
"fromUserName": "",
"toUserAvatar": "",
"toUserName": "",
"erc1155Metadata": null,
"__typename": "NFTHistory"
}
],
"__typename": "NFTHistoryV2"
}
}
}
Field
The table below provides an explanation of each variable in the respective column.
| Name | Type | Description |
|---|---|---|
nftTokenId | UUID1 | The NFT token ID. |
orgId | UUID1 | The organization ID. |
contractAddress | String | The NFT Solana contract address. |
tokenId | String | The NFT Solana token ID. |
networkId | UUID1 | The network ID. |
ownerAddress | String | The connected wallet address. |
limit | Int | Page limit. |
offset | Int | Skip a defined number of records before fetching the next set of results |
currency | Enum | This currency is used to show the currency conversion rate of fiat currency amount. |