JavaScript

import { Avalanche } from "@avalanche-sdk/chainkit";

const avalanche = new Avalanche({
  chainId: "43114",
});

async function run() {
  const result = await avalanche.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();

{
  "transactions": [
    {
      "nativeTransaction": {
        "blockNumber": "<string>",
        "blockTimestamp": 123,
        "blockHash": "<string>",
        "chainId": "<string>",
        "blockIndex": 123,
        "txHash": "<string>",
        "txStatus": "<string>",
        "txType": 123,
        "gasLimit": "<string>",
        "gasUsed": "<string>",
        "gasPrice": "<string>",
        "nonce": "<string>",
        "from": {
          "address": "<string>",
          "name": "<string>",
          "symbol": "<string>",
          "decimals": 123,
          "logoUri": "<string>"
        },
        "to": {
          "address": "<string>",
          "name": "<string>",
          "symbol": "<string>",
          "decimals": 123,
          "logoUri": "<string>"
        },
        "value": "<string>",
        "method": {
          "callType": "NATIVE_TRANSFER",
          "methodHash": "<string>",
          "methodName": "<string>"
        }
      },
      "erc20Transfers": [
        {
          "from": {
            "address": "<string>",
            "name": "<string>",
            "symbol": "<string>",
            "decimals": 123,
            "logoUri": "<string>"
          },
          "to": {
            "address": "<string>",
            "name": "<string>",
            "symbol": "<string>",
            "decimals": 123,
            "logoUri": "<string>"
          },
          "logIndex": 123,
          "value": "<string>",
          "erc20Token": {
            "address": "<string>",
            "name": "<string>",
            "symbol": "<string>",
            "decimals": 123,
            "ercType": "ERC-20",
            "logoUri": "<string>",
            "price": {
              "currencyCode": "usd",
              "value": 123
            }
          }
        }
      ],
      "erc721Transfers": [
        {
          "from": {
            "address": "<string>",
            "name": "<string>",
            "symbol": "<string>",
            "decimals": 123,
            "logoUri": "<string>"
          },
          "to": {
            "address": "<string>",
            "name": "<string>",
            "symbol": "<string>",
            "decimals": 123,
            "logoUri": "<string>"
          },
          "logIndex": 123,
          "erc721Token": {
            "address": "<string>",
            "name": "<string>",
            "symbol": "<string>",
            "ercType": "ERC-721",
            "tokenId": "<string>",
            "tokenUri": "<string>",
            "metadata": {
              "indexStatus": "UNKNOWN",
              "metadataLastUpdatedTimestamp": 123,
              "name": "<string>",
              "symbol": "<string>",
              "imageUri": "<string>",
              "description": "<string>",
              "animationUri": "<string>",
              "externalUrl": "<string>",
              "background": "<string>",
              "attributes": "<string>"
            },
            "ownerAddress": "<string>"
          }
        }
      ],
      "erc1155Transfers": [
        {
          "from": {
            "address": "<string>",
            "name": "<string>",
            "symbol": "<string>",
            "decimals": 123,
            "logoUri": "<string>"
          },
          "to": {
            "address": "<string>",
            "name": "<string>",
            "symbol": "<string>",
            "decimals": 123,
            "logoUri": "<string>"
          },
          "logIndex": 123,
          "value": "<string>",
          "erc1155Token": {
            "address": "<string>",
            "ercType": "ERC-1155",
            "tokenId": "<string>",
            "tokenUri": "<string>",
            "metadata": {
              "indexStatus": "UNKNOWN",
              "metadataLastUpdatedTimestamp": 123,
              "name": "<string>",
              "symbol": "<string>",
              "imageUri": "<string>",
              "description": "<string>",
              "animationUri": "<string>",
              "externalUrl": "<string>",
              "background": "<string>",
              "decimals": 123,
              "properties": "<string>"
            }
          }
        }
      ],
      "internalTransactions": [
        {
          "from": {
            "address": "<string>",
            "name": "<string>",
            "symbol": "<string>",
            "decimals": 123,
            "logoUri": "<string>"
          },
          "to": {
            "address": "<string>",
            "name": "<string>",
            "symbol": "<string>",
            "decimals": 123,
            "logoUri": "<string>"
          },
          "internalTxType": "UNKNOWN",
          "value": "<string>",
          "isReverted": true,
          "gasUsed": "<string>",
          "gasLimit": "<string>"
        }
      ]
    }
  ],
  "nextPageToken": "<string>"
}

Transactions

List transactions

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.

GET

chains

{chainId}

addresses

{address}

transactions

JavaScript

import { Avalanche } from "@avalanche-sdk/chainkit";

const avalanche = new Avalanche({
  chainId: "43114",
});

async function run() {
  const result = await avalanche.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();

{
  "transactions": [
    {
      "nativeTransaction": {
        "blockNumber": "<string>",
        "blockTimestamp": 123,
        "blockHash": "<string>",
        "chainId": "<string>",
        "blockIndex": 123,
        "txHash": "<string>",
        "txStatus": "<string>",
        "txType": 123,
        "gasLimit": "<string>",
        "gasUsed": "<string>",
        "gasPrice": "<string>",
        "nonce": "<string>",
        "from": {
          "address": "<string>",
          "name": "<string>",
          "symbol": "<string>",
          "decimals": 123,
          "logoUri": "<string>"
        },
        "to": {
          "address": "<string>",
          "name": "<string>",
          "symbol": "<string>",
          "decimals": 123,
          "logoUri": "<string>"
        },
        "value": "<string>",
        "method": {
          "callType": "NATIVE_TRANSFER",
          "methodHash": "<string>",
          "methodName": "<string>"
        }
      },
      "erc20Transfers": [
        {
          "from": {
            "address": "<string>",
            "name": "<string>",
            "symbol": "<string>",
            "decimals": 123,
            "logoUri": "<string>"
          },
          "to": {
            "address": "<string>",
            "name": "<string>",
            "symbol": "<string>",
            "decimals": 123,
            "logoUri": "<string>"
          },
          "logIndex": 123,
          "value": "<string>",
          "erc20Token": {
            "address": "<string>",
            "name": "<string>",
            "symbol": "<string>",
            "decimals": 123,
            "ercType": "ERC-20",
            "logoUri": "<string>",
            "price": {
              "currencyCode": "usd",
              "value": 123
            }
          }
        }
      ],
      "erc721Transfers": [
        {
          "from": {
            "address": "<string>",
            "name": "<string>",
            "symbol": "<string>",
            "decimals": 123,
            "logoUri": "<string>"
          },
          "to": {
            "address": "<string>",
            "name": "<string>",
            "symbol": "<string>",
            "decimals": 123,
            "logoUri": "<string>"
          },
          "logIndex": 123,
          "erc721Token": {
            "address": "<string>",
            "name": "<string>",
            "symbol": "<string>",
            "ercType": "ERC-721",
            "tokenId": "<string>",
            "tokenUri": "<string>",
            "metadata": {
              "indexStatus": "UNKNOWN",
              "metadataLastUpdatedTimestamp": 123,
              "name": "<string>",
              "symbol": "<string>",
              "imageUri": "<string>",
              "description": "<string>",
              "animationUri": "<string>",
              "externalUrl": "<string>",
              "background": "<string>",
              "attributes": "<string>"
            },
            "ownerAddress": "<string>"
          }
        }
      ],
      "erc1155Transfers": [
        {
          "from": {
            "address": "<string>",
            "name": "<string>",
            "symbol": "<string>",
            "decimals": 123,
            "logoUri": "<string>"
          },
          "to": {
            "address": "<string>",
            "name": "<string>",
            "symbol": "<string>",
            "decimals": 123,
            "logoUri": "<string>"
          },
          "logIndex": 123,
          "value": "<string>",
          "erc1155Token": {
            "address": "<string>",
            "ercType": "ERC-1155",
            "tokenId": "<string>",
            "tokenUri": "<string>",
            "metadata": {
              "indexStatus": "UNKNOWN",
              "metadataLastUpdatedTimestamp": 123,
              "name": "<string>",
              "symbol": "<string>",
              "imageUri": "<string>",
              "description": "<string>",
              "animationUri": "<string>",
              "externalUrl": "<string>",
              "background": "<string>",
              "decimals": 123,
              "properties": "<string>"
            }
          }
        }
      ],
      "internalTransactions": [
        {
          "from": {
            "address": "<string>",
            "name": "<string>",
            "symbol": "<string>",
            "decimals": 123,
            "logoUri": "<string>"
          },
          "to": {
            "address": "<string>",
            "name": "<string>",
            "symbol": "<string>",
            "decimals": 123,
            "logoUri": "<string>"
          },
          "internalTxType": "UNKNOWN",
          "value": "<string>",
          "isReverted": true,
          "gasUsed": "<string>",
          "gasLimit": "<string>"
        }
      ]
    }
  ],
  "nextPageToken": "<string>"
}

Authorizations

x-glacier-api-key

string

header

required

Api keys provide higher access to rate limits. To obtain an api key, sign up for an account at https://avacloud.io/.

Path Parameters

chainId

string

required

A supported evm chain id or blockchain id. Use the /chains endpoint to get a list of supported chain ids.

address

string

required

A wallet address.

Query Parameters

pageToken

string

A page token, received from a previous list call. Provide this to retrieve the subsequent page.

pageSize

integer

default:10

The maximum number of items to return. The minimum page size is 1. The maximum pageSize is 100.

Required range: 1 <= x <= 100

startBlock

number

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.

endBlock

number

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.

sortOrder

enum<string>

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.

Available options:

asc,

desc

Response

Successful response

transactions

object[]

required

Show child attributes

transactions.nativeTransaction

object

required

The native (top-level) transaction details.

Show child attributes

transactions.nativeTransaction.blockNumber

string

required

The block number on the chain.

transactions.nativeTransaction.blockTimestamp

number

required

The block finality timestamp.

transactions.nativeTransaction.blockHash

string

required

The block hash identifier.

transactions.nativeTransaction.chainId

string

required

The EVM chain ID on which the transaction occured.

transactions.nativeTransaction.blockIndex

number

required

The index at which the transaction occured in the block (0-indexed).

transactions.nativeTransaction.txHash

string

required

The transaction hash identifier.

transactions.nativeTransaction.txStatus

string

required

The transaction status, which is either 0 (failed) or 1 (successful).

transactions.nativeTransaction.txType

number

required

The transaction type.

transactions.nativeTransaction.gasLimit

string

required

The gas limit set for the transaction.

transactions.nativeTransaction.gasUsed

string

required

The amount of gas used.

transactions.nativeTransaction.gasPrice

string

required

The gas price denominated by the number of decimals of the native token.

transactions.nativeTransaction.nonce

string

required

The nonce used by the sender of the transaction.

transactions.nativeTransaction.from

object

required

Show child attributes

transactions.nativeTransaction.from.address

string

required

A wallet or contract address in mixed-case checksum encoding.

transactions.nativeTransaction.from.name

string

The contract name.

transactions.nativeTransaction.from.symbol

string

The contract symbol.

transactions.nativeTransaction.from.decimals

number

The number of decimals the token uses. For example 6, means to divide the token amount by 1000000 to get its user representation.

transactions.nativeTransaction.from.logoUri

string

The logo uri for the address.

transactions.nativeTransaction.to

object

required

Show child attributes

transactions.nativeTransaction.to.address

string

required

A wallet or contract address in mixed-case checksum encoding.

transactions.nativeTransaction.to.name

string

The contract name.

transactions.nativeTransaction.to.symbol

string

The contract symbol.

transactions.nativeTransaction.to.decimals

number

The number of decimals the token uses. For example 6, means to divide the token amount by 1000000 to get its user representation.

transactions.nativeTransaction.to.logoUri

string

The logo uri for the address.

transactions.nativeTransaction.value

string

required

transactions.nativeTransaction.method

object

Show child attributes

transactions.nativeTransaction.method.callType

enum<string>

required

The contract call type. NATIVE_TRANSFER indicates a transfer of the native token without any smart-contract interaction. CONTRACT_CALL indicates a smart-contract interaction. CONTRACT_CREATION indicates a smart-contract creation.

Available options:

NATIVE_TRANSFER,

CONTRACT_CALL,

CONTRACT_CREATION

transactions.nativeTransaction.method.methodHash

string

required

The contract method hash identifier. The method hash is only set if the callType is CONTRACT_CALL.

transactions.nativeTransaction.method.methodName

string

The contract method name including parameter types. If the callType is NATIVE_TRANSFER this is set to 'Native Transfer'. If the callType is CONTRACT_CREATION this is set to 'Contract Created'.

transactions.erc20Transfers

object[]

The list of ERC-20 transfers.

Show child attributes

transactions.erc20Transfers.from

object

required

Show child attributes

transactions.erc20Transfers.from.address

string

required

A wallet or contract address in mixed-case checksum encoding.

transactions.erc20Transfers.from.name

string

The contract name.

transactions.erc20Transfers.from.symbol

string

The contract symbol.

transactions.erc20Transfers.from.decimals

number

The number of decimals the token uses. For example 6, means to divide the token amount by 1000000 to get its user representation.

transactions.erc20Transfers.from.logoUri

string

The logo uri for the address.

transactions.erc20Transfers.to

object

required

Show child attributes

transactions.erc20Transfers.to.address

string

required

A wallet or contract address in mixed-case checksum encoding.

transactions.erc20Transfers.to.name

string

The contract name.

transactions.erc20Transfers.to.symbol

string

The contract symbol.

transactions.erc20Transfers.to.decimals

number

The number of decimals the token uses. For example 6, means to divide the token amount by 1000000 to get its user representation.

transactions.erc20Transfers.to.logoUri

string

The logo uri for the address.

transactions.erc20Transfers.logIndex

number

required

transactions.erc20Transfers.value

string

required

transactions.erc20Transfers.erc20Token

object

required

Show child attributes

transactions.erc20Transfers.erc20Token.address

string

required

A wallet or contract address in mixed-case checksum encoding.

transactions.erc20Transfers.erc20Token.name

string

required

The contract name.

transactions.erc20Transfers.erc20Token.symbol

string

required

The contract symbol.

transactions.erc20Transfers.erc20Token.decimals

number

required

The number of decimals the token uses. For example 6, means to divide the token amount by 1000000 to get its user representation.

transactions.erc20Transfers.erc20Token.ercType

enum<string>

required

Available options:

ERC-20

transactions.erc20Transfers.erc20Token.logoUri

string

The logo uri for the address.

transactions.erc20Transfers.erc20Token.price

object

The token price, if available.

Show child attributes

transactions.erc20Transfers.erc20Token.price.currencyCode

enum<string>

required

ISO 4217 currency code.

Available options:

usd,

eur,

aud,

cad,

chf,

clp,

cny,

czk,

dkk,

gbp,

hkd,

huf,

jpy,

nzd

transactions.erc20Transfers.erc20Token.price.value

number

required

Monetary value in base 10 decimals.

transactions.erc721Transfers

object[]

The list of ERC-721 transfers.

Show child attributes

transactions.erc721Transfers.from

object

required

Show child attributes

transactions.erc721Transfers.from.address

string

required

A wallet or contract address in mixed-case checksum encoding.

transactions.erc721Transfers.from.name

string

The contract name.

transactions.erc721Transfers.from.symbol

string

The contract symbol.

transactions.erc721Transfers.from.decimals

number

The number of decimals the token uses. For example 6, means to divide the token amount by 1000000 to get its user representation.

transactions.erc721Transfers.from.logoUri

string

The logo uri for the address.

transactions.erc721Transfers.to

object

required

Show child attributes

transactions.erc721Transfers.to.address

string

required

A wallet or contract address in mixed-case checksum encoding.

transactions.erc721Transfers.to.name

string

The contract name.

transactions.erc721Transfers.to.symbol

string

The contract symbol.

transactions.erc721Transfers.to.decimals

number

The number of decimals the token uses. For example 6, means to divide the token amount by 1000000 to get its user representation.

transactions.erc721Transfers.to.logoUri

string

The logo uri for the address.

transactions.erc721Transfers.logIndex

number

required

transactions.erc721Transfers.erc721Token

object

required

Show child attributes

transactions.erc721Transfers.erc721Token.address

string

required

A wallet or contract address in mixed-case checksum encoding.

transactions.erc721Transfers.erc721Token.name

string

required

The contract name.

transactions.erc721Transfers.erc721Token.symbol

string

required

The contract symbol.

transactions.erc721Transfers.erc721Token.ercType

enum<string>

required

Available options:

ERC-721

transactions.erc721Transfers.erc721Token.tokenId

string

required

transactions.erc721Transfers.erc721Token.tokenUri

string

required

transactions.erc721Transfers.erc721Token.metadata

object

required

Show child attributes

transactions.erc721Transfers.erc721Token.metadata.indexStatus

enum<string>

required

The metadata indexing status of the nft.

Available options:

UNKNOWN,

MISSING_TOKEN,

INVALID_TOKEN_URI,

INVALID_TOKEN_URI_SCHEME,

UNREACHABLE_TOKEN_URI,

THROTTLED_TOKEN_URI,

METADATA_CONTENT_TOO_LARGE,

INVALID_METADATA,

INVALID_METADATA_JSON,

INDEXED,

UNINDEXED

transactions.erc721Transfers.erc721Token.metadata.metadataLastUpdatedTimestamp

number

transactions.erc721Transfers.erc721Token.metadata.name

string

transactions.erc721Transfers.erc721Token.metadata.symbol

string

transactions.erc721Transfers.erc721Token.metadata.imageUri

string

transactions.erc721Transfers.erc721Token.metadata.description

string

transactions.erc721Transfers.erc721Token.metadata.animationUri

string

transactions.erc721Transfers.erc721Token.metadata.externalUrl

string

transactions.erc721Transfers.erc721Token.metadata.background

string

transactions.erc721Transfers.erc721Token.metadata.attributes

string

transactions.erc721Transfers.erc721Token.ownerAddress

string

A wallet or contract address in mixed-case checksum encoding.

transactions.erc1155Transfers

object[]

The list of ERC-1155 transfers.

Show child attributes

transactions.erc1155Transfers.from

object

required

Show child attributes

transactions.erc1155Transfers.from.address

string

required

A wallet or contract address in mixed-case checksum encoding.

transactions.erc1155Transfers.from.name

string

The contract name.

transactions.erc1155Transfers.from.symbol

string

The contract symbol.

transactions.erc1155Transfers.from.decimals

number

The number of decimals the token uses. For example 6, means to divide the token amount by 1000000 to get its user representation.

transactions.erc1155Transfers.from.logoUri

string

The logo uri for the address.

transactions.erc1155Transfers.to

object

required

Show child attributes

transactions.erc1155Transfers.to.address

string

required

A wallet or contract address in mixed-case checksum encoding.

transactions.erc1155Transfers.to.name

string

The contract name.

transactions.erc1155Transfers.to.symbol

string

The contract symbol.

transactions.erc1155Transfers.to.decimals

number

The number of decimals the token uses. For example 6, means to divide the token amount by 1000000 to get its user representation.

transactions.erc1155Transfers.to.logoUri

string

The logo uri for the address.

transactions.erc1155Transfers.logIndex

number

required

transactions.erc1155Transfers.value

string

required

transactions.erc1155Transfers.erc1155Token

object

required

Show child attributes

transactions.erc1155Transfers.erc1155Token.address

string

required

A wallet or contract address in mixed-case checksum encoding.

transactions.erc1155Transfers.erc1155Token.ercType

enum<string>

required

Available options:

ERC-1155

transactions.erc1155Transfers.erc1155Token.tokenId

string

required

transactions.erc1155Transfers.erc1155Token.tokenUri

string

required

transactions.erc1155Transfers.erc1155Token.metadata

object

required

Show child attributes

transactions.erc1155Transfers.erc1155Token.metadata.indexStatus

enum<string>

required

The metadata indexing status of the nft.

Available options:

UNKNOWN,

MISSING_TOKEN,

INVALID_TOKEN_URI,

INVALID_TOKEN_URI_SCHEME,

UNREACHABLE_TOKEN_URI,

THROTTLED_TOKEN_URI,

METADATA_CONTENT_TOO_LARGE,

INVALID_METADATA,

INVALID_METADATA_JSON,

INDEXED,

UNINDEXED

transactions.erc1155Transfers.erc1155Token.metadata.metadataLastUpdatedTimestamp

number

transactions.erc1155Transfers.erc1155Token.metadata.name

string

transactions.erc1155Transfers.erc1155Token.metadata.symbol

string

transactions.erc1155Transfers.erc1155Token.metadata.imageUri

string

transactions.erc1155Transfers.erc1155Token.metadata.description

string

transactions.erc1155Transfers.erc1155Token.metadata.animationUri

string

transactions.erc1155Transfers.erc1155Token.metadata.externalUrl

string

transactions.erc1155Transfers.erc1155Token.metadata.background

string

transactions.erc1155Transfers.erc1155Token.metadata.decimals

number

transactions.erc1155Transfers.erc1155Token.metadata.properties

string

transactions.internalTransactions

object[]

The list of internal transactions. Note that this list only includes CALL and CALLCODE internal transactions that had a non-zero value and CREATE/CREATE2/CREATE3 calls. Use a client provider to recieve a full debug trace of the transaction.

Show child attributes

transactions.internalTransactions.from

object

required

Show child attributes

transactions.internalTransactions.from.address

string

required

A wallet or contract address in mixed-case checksum encoding.

transactions.internalTransactions.from.name

string

The contract name.

transactions.internalTransactions.from.symbol

string

The contract symbol.

transactions.internalTransactions.from.decimals

number

The number of decimals the token uses. For example 6, means to divide the token amount by 1000000 to get its user representation.

transactions.internalTransactions.from.logoUri

string

The logo uri for the address.

transactions.internalTransactions.to

object

required

Show child attributes

transactions.internalTransactions.to.address

string

required

A wallet or contract address in mixed-case checksum encoding.

transactions.internalTransactions.to.name

string

The contract name.

transactions.internalTransactions.to.symbol

string

The contract symbol.

transactions.internalTransactions.to.decimals

number

The number of decimals the token uses. For example 6, means to divide the token amount by 1000000 to get its user representation.

transactions.internalTransactions.to.logoUri

string

The logo uri for the address.

transactions.internalTransactions.internalTxType

enum<string>

required

Available options:

UNKNOWN,

CALL,

CREATE,

CREATE2,

CREATE3,

CALLCODE,

DELEGATECALL,

STATICCALL

transactions.internalTransactions.value

string

required

transactions.internalTransactions.isReverted

boolean

required

True if the internal transaction was reverted.

transactions.internalTransactions.gasUsed

string

required

transactions.internalTransactions.gasLimit

string

required

nextPageToken

string

A token, which can be sent as pageToken to retrieve the next page. If this field is omitted or empty, there are no subsequent pages.

List ERC transfers

List native transactions

⌘I

Get Started

Learn

Health Check

EVM

Primary Network

ICM Services

Operations

Usage Metrics

List transactions

Authorizations

Path Parameters

Query Parameters

Response