import { AvaCloudSDK } from "@avalabs/avacloud-sdk";
const avaCloudSDK = new AvaCloudSDK({
serverURL: "https://api.example.com",
chainId: "43114",
});
async function run() {
const result = await avaCloudSDK.data.evm.address.transactions.list({
pageSize: 10,
startBlock: 6479329,
endBlock: 6479330,
address: "0x71C7656EC7ab88b098defB751B7401B5f6d8976F",
sortOrder: "asc",
});
for await (const page of result) {
console.log(page);
}
}
run();
{
"nextPageToken": "<string>",
"transactions": [
{
"nativeTransaction": {
"blockNumber": "339",
"blockTimestamp": 1648672486,
"blockHash": "0x17533aeb5193378b9ff441d61728e7a2ebaf10f61fd5310759451627dfca2e7c",
"chainId": "43114",
"blockIndex": 0,
"txHash": "0x3e9303f81be00b4af28515dab7b914bf3dbff209ea10e7071fa24d4af0a112d4",
"txStatus": "1",
"txType": 1,
"gasLimit": "51373",
"gasUsed": "51373",
"gasPrice": "470000000000",
"nonce": "1",
"from": {
"name": "Wrapped AVAX",
"symbol": "WAVAX",
"decimals": 18,
"logoUri": "https://images.ctfassets.net/gcj8jwzm6086/5VHupNKwnDYJvqMENeV7iJ/fdd6326b7a82c8388e4ee9d4be7062d4/avalanche-avax-logo.svg",
"address": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F"
},
"to": {
"name": "Wrapped AVAX",
"symbol": "WAVAX",
"decimals": 18,
"logoUri": "https://images.ctfassets.net/gcj8jwzm6086/5VHupNKwnDYJvqMENeV7iJ/fdd6326b7a82c8388e4ee9d4be7062d4/avalanche-avax-logo.svg",
"address": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F"
},
"method": {
"callType": "CONTRACT_CALL",
"methodHash": "0xa9059cbb",
"methodName": "transfer(address,uint256)"
},
"value": "10000000000000000000"
},
"erc20Transfers": [
{
"from": {
"name": "Wrapped AVAX",
"symbol": "WAVAX",
"decimals": 18,
"logoUri": "https://images.ctfassets.net/gcj8jwzm6086/5VHupNKwnDYJvqMENeV7iJ/fdd6326b7a82c8388e4ee9d4be7062d4/avalanche-avax-logo.svg",
"address": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F"
},
"to": {
"name": "Wrapped AVAX",
"symbol": "WAVAX",
"decimals": 18,
"logoUri": "https://images.ctfassets.net/gcj8jwzm6086/5VHupNKwnDYJvqMENeV7iJ/fdd6326b7a82c8388e4ee9d4be7062d4/avalanche-avax-logo.svg",
"address": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F"
},
"logIndex": 123,
"value": "10000000000000000000",
"erc20Token": {
"address": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F",
"name": "Wrapped AVAX",
"symbol": "WAVAX",
"decimals": 18,
"logoUri": "https://images.ctfassets.net/gcj8jwzm6086/5VHupNKwnDYJvqMENeV7iJ/fdd6326b7a82c8388e4ee9d4be7062d4/avalanche-avax-logo.svg",
"ercType": "ERC-20",
"price": {
"currencyCode": "usd",
"value": "42.42"
}
}
}
],
"erc721Transfers": [
{
"from": {
"name": "Wrapped AVAX",
"symbol": "WAVAX",
"decimals": 18,
"logoUri": "https://images.ctfassets.net/gcj8jwzm6086/5VHupNKwnDYJvqMENeV7iJ/fdd6326b7a82c8388e4ee9d4be7062d4/avalanche-avax-logo.svg",
"address": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F"
},
"to": {
"name": "Wrapped AVAX",
"symbol": "WAVAX",
"decimals": 18,
"logoUri": "https://images.ctfassets.net/gcj8jwzm6086/5VHupNKwnDYJvqMENeV7iJ/fdd6326b7a82c8388e4ee9d4be7062d4/avalanche-avax-logo.svg",
"address": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F"
},
"logIndex": 123,
"erc721Token": {
"address": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F",
"name": "Wrapped AVAX",
"symbol": "WAVAX",
"ercType": "ERC-721",
"tokenId": "<string>",
"tokenUri": "<string>",
"metadata": {
"indexStatus": "indexed",
"metadataLastUpdatedTimestamp": 123,
"name": "<string>",
"symbol": "<string>",
"imageUri": "<string>",
"description": "<string>",
"animationUri": "<string>",
"externalUrl": "<string>",
"background": "<string>",
"attributes": "<string>"
},
"ownerAddress": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F"
}
}
],
"erc1155Transfers": [
{
"from": {
"name": "Wrapped AVAX",
"symbol": "WAVAX",
"decimals": 18,
"logoUri": "https://images.ctfassets.net/gcj8jwzm6086/5VHupNKwnDYJvqMENeV7iJ/fdd6326b7a82c8388e4ee9d4be7062d4/avalanche-avax-logo.svg",
"address": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F"
},
"to": {
"name": "Wrapped AVAX",
"symbol": "WAVAX",
"decimals": 18,
"logoUri": "https://images.ctfassets.net/gcj8jwzm6086/5VHupNKwnDYJvqMENeV7iJ/fdd6326b7a82c8388e4ee9d4be7062d4/avalanche-avax-logo.svg",
"address": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F"
},
"logIndex": 123,
"value": "10000000000000000000",
"erc1155Token": {
"address": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F",
"ercType": "ERC-1155",
"tokenId": "<string>",
"tokenUri": "<string>",
"metadata": {
"indexStatus": "indexed",
"metadataLastUpdatedTimestamp": 123,
"name": "<string>",
"symbol": "<string>",
"imageUri": "<string>",
"description": "<string>",
"animationUri": "<string>",
"externalUrl": "<string>",
"background": "<string>",
"decimals": 123,
"properties": "<string>"
}
}
}
],
"internalTransactions": [
{
"from": {
"name": "Wrapped AVAX",
"symbol": "WAVAX",
"decimals": 18,
"logoUri": "https://images.ctfassets.net/gcj8jwzm6086/5VHupNKwnDYJvqMENeV7iJ/fdd6326b7a82c8388e4ee9d4be7062d4/avalanche-avax-logo.svg",
"address": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F"
},
"to": {
"name": "Wrapped AVAX",
"symbol": "WAVAX",
"decimals": 18,
"logoUri": "https://images.ctfassets.net/gcj8jwzm6086/5VHupNKwnDYJvqMENeV7iJ/fdd6326b7a82c8388e4ee9d4be7062d4/avalanche-avax-logo.svg",
"address": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F"
},
"internalTxType": "UNKNOWN",
"value": "10000000000000000000",
"isReverted": true,
"gasUsed": "<string>",
"gasLimit": "<string>"
}
]
}
]
}
Returns a list of transactions where the given wallet address had an on-chain interaction for the given chain. The ERC-20 transfers, ERC-721 transfers, ERC-1155, and internal transactions returned are only those where the input address had an interaction. Specifically, those lists only inlcude entries where the input address was the sender (from
field) or the receiver (to
field) for the sub-transaction. Therefore the transactions returned from this list may not be complete representations of the on-chain data. For a complete view of a transaction use the /chains/:chainId/transactions/:txHash
endpoint.
Filterable by block ranges.
import { AvaCloudSDK } from "@avalabs/avacloud-sdk";
const avaCloudSDK = new AvaCloudSDK({
serverURL: "https://api.example.com",
chainId: "43114",
});
async function run() {
const result = await avaCloudSDK.data.evm.address.transactions.list({
pageSize: 10,
startBlock: 6479329,
endBlock: 6479330,
address: "0x71C7656EC7ab88b098defB751B7401B5f6d8976F",
sortOrder: "asc",
});
for await (const page of result) {
console.log(page);
}
}
run();
{
"nextPageToken": "<string>",
"transactions": [
{
"nativeTransaction": {
"blockNumber": "339",
"blockTimestamp": 1648672486,
"blockHash": "0x17533aeb5193378b9ff441d61728e7a2ebaf10f61fd5310759451627dfca2e7c",
"chainId": "43114",
"blockIndex": 0,
"txHash": "0x3e9303f81be00b4af28515dab7b914bf3dbff209ea10e7071fa24d4af0a112d4",
"txStatus": "1",
"txType": 1,
"gasLimit": "51373",
"gasUsed": "51373",
"gasPrice": "470000000000",
"nonce": "1",
"from": {
"name": "Wrapped AVAX",
"symbol": "WAVAX",
"decimals": 18,
"logoUri": "https://images.ctfassets.net/gcj8jwzm6086/5VHupNKwnDYJvqMENeV7iJ/fdd6326b7a82c8388e4ee9d4be7062d4/avalanche-avax-logo.svg",
"address": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F"
},
"to": {
"name": "Wrapped AVAX",
"symbol": "WAVAX",
"decimals": 18,
"logoUri": "https://images.ctfassets.net/gcj8jwzm6086/5VHupNKwnDYJvqMENeV7iJ/fdd6326b7a82c8388e4ee9d4be7062d4/avalanche-avax-logo.svg",
"address": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F"
},
"method": {
"callType": "CONTRACT_CALL",
"methodHash": "0xa9059cbb",
"methodName": "transfer(address,uint256)"
},
"value": "10000000000000000000"
},
"erc20Transfers": [
{
"from": {
"name": "Wrapped AVAX",
"symbol": "WAVAX",
"decimals": 18,
"logoUri": "https://images.ctfassets.net/gcj8jwzm6086/5VHupNKwnDYJvqMENeV7iJ/fdd6326b7a82c8388e4ee9d4be7062d4/avalanche-avax-logo.svg",
"address": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F"
},
"to": {
"name": "Wrapped AVAX",
"symbol": "WAVAX",
"decimals": 18,
"logoUri": "https://images.ctfassets.net/gcj8jwzm6086/5VHupNKwnDYJvqMENeV7iJ/fdd6326b7a82c8388e4ee9d4be7062d4/avalanche-avax-logo.svg",
"address": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F"
},
"logIndex": 123,
"value": "10000000000000000000",
"erc20Token": {
"address": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F",
"name": "Wrapped AVAX",
"symbol": "WAVAX",
"decimals": 18,
"logoUri": "https://images.ctfassets.net/gcj8jwzm6086/5VHupNKwnDYJvqMENeV7iJ/fdd6326b7a82c8388e4ee9d4be7062d4/avalanche-avax-logo.svg",
"ercType": "ERC-20",
"price": {
"currencyCode": "usd",
"value": "42.42"
}
}
}
],
"erc721Transfers": [
{
"from": {
"name": "Wrapped AVAX",
"symbol": "WAVAX",
"decimals": 18,
"logoUri": "https://images.ctfassets.net/gcj8jwzm6086/5VHupNKwnDYJvqMENeV7iJ/fdd6326b7a82c8388e4ee9d4be7062d4/avalanche-avax-logo.svg",
"address": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F"
},
"to": {
"name": "Wrapped AVAX",
"symbol": "WAVAX",
"decimals": 18,
"logoUri": "https://images.ctfassets.net/gcj8jwzm6086/5VHupNKwnDYJvqMENeV7iJ/fdd6326b7a82c8388e4ee9d4be7062d4/avalanche-avax-logo.svg",
"address": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F"
},
"logIndex": 123,
"erc721Token": {
"address": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F",
"name": "Wrapped AVAX",
"symbol": "WAVAX",
"ercType": "ERC-721",
"tokenId": "<string>",
"tokenUri": "<string>",
"metadata": {
"indexStatus": "indexed",
"metadataLastUpdatedTimestamp": 123,
"name": "<string>",
"symbol": "<string>",
"imageUri": "<string>",
"description": "<string>",
"animationUri": "<string>",
"externalUrl": "<string>",
"background": "<string>",
"attributes": "<string>"
},
"ownerAddress": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F"
}
}
],
"erc1155Transfers": [
{
"from": {
"name": "Wrapped AVAX",
"symbol": "WAVAX",
"decimals": 18,
"logoUri": "https://images.ctfassets.net/gcj8jwzm6086/5VHupNKwnDYJvqMENeV7iJ/fdd6326b7a82c8388e4ee9d4be7062d4/avalanche-avax-logo.svg",
"address": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F"
},
"to": {
"name": "Wrapped AVAX",
"symbol": "WAVAX",
"decimals": 18,
"logoUri": "https://images.ctfassets.net/gcj8jwzm6086/5VHupNKwnDYJvqMENeV7iJ/fdd6326b7a82c8388e4ee9d4be7062d4/avalanche-avax-logo.svg",
"address": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F"
},
"logIndex": 123,
"value": "10000000000000000000",
"erc1155Token": {
"address": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F",
"ercType": "ERC-1155",
"tokenId": "<string>",
"tokenUri": "<string>",
"metadata": {
"indexStatus": "indexed",
"metadataLastUpdatedTimestamp": 123,
"name": "<string>",
"symbol": "<string>",
"imageUri": "<string>",
"description": "<string>",
"animationUri": "<string>",
"externalUrl": "<string>",
"background": "<string>",
"decimals": 123,
"properties": "<string>"
}
}
}
],
"internalTransactions": [
{
"from": {
"name": "Wrapped AVAX",
"symbol": "WAVAX",
"decimals": 18,
"logoUri": "https://images.ctfassets.net/gcj8jwzm6086/5VHupNKwnDYJvqMENeV7iJ/fdd6326b7a82c8388e4ee9d4be7062d4/avalanche-avax-logo.svg",
"address": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F"
},
"to": {
"name": "Wrapped AVAX",
"symbol": "WAVAX",
"decimals": 18,
"logoUri": "https://images.ctfassets.net/gcj8jwzm6086/5VHupNKwnDYJvqMENeV7iJ/fdd6326b7a82c8388e4ee9d4be7062d4/avalanche-avax-logo.svg",
"address": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F"
},
"internalTxType": "UNKNOWN",
"value": "10000000000000000000",
"isReverted": true,
"gasUsed": "<string>",
"gasLimit": "<string>"
}
]
}
]
}
Api keys provide higher access to rate limits. To obtain an api key, sign up for an account at https://avacloud.io/.
A supported evm chain id or blockchain id. Use the /chains
endpoint to get a list of supported chain ids.
A wallet address.
A page token, received from a previous list call. Provide this to retrieve the subsequent page.
The maximum number of items to return. The minimum page size is 1. The maximum pageSize is 100.
1 <= x <= 100
The block range start number, inclusive. If endBlock is not defined when startBlock is defined, the end of the range will be the most recent block.
The block range end number, exclusive. If startBlock is not defined when endBlock is defined, the start of the range will be the genesis block.
The order by which to sort results. Use "asc" for ascending order, "desc" for descending order. Sorted by timestamp or the sortBy
query parameter, if provided.
asc
, desc
Successful response
The response is of type object
.
Was this page helpful?