List latest transactions

Lists the latest transactions on one of the Primary Network chains.

Transactions are filterable by addresses, txTypes, and timestamps. When querying for latest transactions without an address parameter, filtering by txTypes and timestamps is not supported. An address filter must be provided to utilize txTypes and timestamp filters.

For P-Chain, you can fetch all L1 validators related transactions like ConvertSubnetToL1Tx, IncreaseL1ValidatorBalanceTx etc. using the unique L1 validation ID. These transactions are further filterable by txTypes and timestamps as well.

Given that each transaction may return a large number of UTXO objects, bounded only by the maximum transaction size, the query may return less transactions than the provided page size. The result will contain less results than the page size if the number of utxos contained in the resulting transactions reach a performance threshold.

Authorizations

x-glacier-api-key

string

headerrequired

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

Path Parameters

blockchainId

enum<string>

required

A primary network blockchain id or alias.

Available options:

11111111111111111111111111111111LpoYY,

2oYMBNV4eNHyqk2fjjV5nVQLDbtmNJzq5s3qs3Lo6ftnC6FByM,

2JVSBoinj9C2J33VntvzYtVJNZdN2NKiwwKjcumHUWEb5DbBrm,

2piQ2AVHCjnduiWXsSY15DtbVuwHE2cwMHYnEXHsLL73BBkdbV,

2q9e4r6Mu3U68nU1fYjgbR6JvwrRx36CohpAX5UQxse55x1Q5,

yH8D7ThNJkxmtkuv2jgBa4P1Rn3Qpr4pPr7QYNfcdoS6k6HWp,

vV3cui1DsEPC3nLCGH9rorwo8s6BYxM2Hz4QFE5gEYjwTqAu,

p-chain,

x-chain,

c-chain

network

enum<string>

required

Either mainnet or testnet/fuji.

Available options:

mainnet,

fuji,

testnet,

devnet

Query Parameters

addresses

string

A comma separated list of X-Chain or P-Chain wallet addresses, starting with "avax"/"fuji", "P-avax"/"P-fuji" or "X-avax"/"X-fuji". Also accepts EVM formatted addresses starting with "0x" for C-Chain-related atomic transaction lookups.

l1ValidationId

string

txTypes

enum<string>[]

Query param for filtering items based on transaction types.

Available options:

AddValidatorTx,

AddSubnetValidatorTx,

AddDelegatorTx,

CreateChainTx,

CreateSubnetTx,

ImportTx,

ExportTx,

AdvanceTimeTx,

RewardValidatorTx,

RemoveSubnetValidatorTx,

TransformSubnetTx,

AddPermissionlessValidatorTx,

AddPermissionlessDelegatorTx,

BaseTx,

TransferSubnetOwnershipTx,

ConvertSubnetToL1Tx,

RegisterL1ValidatorTx,

SetL1ValidatorWeightTx,

DisableL1ValidatorTx,

IncreaseL1ValidatorBalanceTx,

UNKNOWN,

CreateAssetTx,

OperationTx

startTimestamp

integer

Query param for retrieving items after a specific timestamp.

Required range: x > 0

endTimestamp

integer

Query param for retrieving items before a specific timestamp.

Required range: x > 0

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

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

200 - application/json

• Option 1
• Option 2
• Option 3

transactions

object[]

required

Show child attributes

transactions.txHash

string

required

A P-Chain transaction hash.

transactions.txType

enum<string>

required

Available options:

AddValidatorTx,

AddSubnetValidatorTx,

AddDelegatorTx,

CreateChainTx,

CreateSubnetTx,

ImportTx,

ExportTx,

AdvanceTimeTx,

RewardValidatorTx,

RemoveSubnetValidatorTx,

TransformSubnetTx,

AddPermissionlessValidatorTx,

AddPermissionlessDelegatorTx,

BaseTx,

TransferSubnetOwnershipTx,

ConvertSubnetToL1Tx,

RegisterL1ValidatorTx,

SetL1ValidatorWeightTx,

DisableL1ValidatorTx,

IncreaseL1ValidatorBalanceTx,

UNKNOWN

transactions.blockTimestamp

number

required

The block finality timestamp.

transactions.blockNumber

string

required

transactions.blockHash

string

required

transactions.consumedUtxos

object[]

required

Show child attributes

transactions.consumedUtxos.addresses

string[]

required

Addresses that are eligible to sign the consumption of this output.

transactions.consumedUtxos.asset

object

required

Show child attributes

transactions.consumedUtxos.asset.assetId

string

required

Unique ID for an asset.

transactions.consumedUtxos.asset.name

string

required

Name of this asset.

transactions.consumedUtxos.asset.symbol

string

required

Symbol for this asset (max 4 characters).

transactions.consumedUtxos.asset.denomination

number

required

Denomination of this asset to represent fungibility.

transactions.consumedUtxos.asset.type

enum<string>

required

Type of asset like SECP256K1 or NFT.

Available options:

secp256k1,

nft

transactions.consumedUtxos.asset.amount

string

required

Amount of the asset.

transactions.consumedUtxos.consumedOnChainId

string

required

Blockchain ID on which this output is consumed on.

transactions.consumedUtxos.consumingTxHash

string

Transaction ID that consumed this output.

transactions.consumedUtxos.createdOnChainId

string

required

Blockchain ID on which this output is created on.

transactions.consumedUtxos.utxoId

string

required

UTXO ID for this output.

transactions.consumedUtxos.amount

string

requireddeprecated

transactions.consumedUtxos.assetId

string

requireddeprecated

transactions.consumedUtxos.blockNumber

string

required

transactions.consumedUtxos.blockTimestamp

number

required

transactions.consumedUtxos.consumingBlockNumber

string

transactions.consumedUtxos.consumingBlockTimestamp

number

transactions.consumedUtxos.platformLocktime

number

transactions.consumedUtxos.outputIndex

number

required

transactions.consumedUtxos.rewardType

enum<string>

Available options:

VALIDATOR,

DELEGATOR,

VALIDATOR_FEE

transactions.consumedUtxos.stakeableLocktime

number

transactions.consumedUtxos.staked

boolean

transactions.consumedUtxos.threshold

number

transactions.consumedUtxos.txHash

string

required

transactions.consumedUtxos.utxoEndTimestamp

number

transactions.consumedUtxos.utxoStartTimestamp

number

transactions.consumedUtxos.utxoType

enum<string>

required

Available options:

STAKE,

TRANSFER

transactions.emittedUtxos

object[]

required

Show child attributes

transactions.emittedUtxos.addresses

string[]

required

Addresses that are eligible to sign the consumption of this output.

transactions.emittedUtxos.asset

object

required

Show child attributes

transactions.emittedUtxos.asset.assetId

string

required

Unique ID for an asset.

transactions.emittedUtxos.asset.name

string

required

Name of this asset.

transactions.emittedUtxos.asset.symbol

string

required

Symbol for this asset (max 4 characters).

transactions.emittedUtxos.asset.denomination

number

required

Denomination of this asset to represent fungibility.

transactions.emittedUtxos.asset.type

enum<string>

required

Type of asset like SECP256K1 or NFT.

Available options:

secp256k1,

nft

transactions.emittedUtxos.asset.amount

string

required

Amount of the asset.

transactions.emittedUtxos.consumedOnChainId

string

required

Blockchain ID on which this output is consumed on.

transactions.emittedUtxos.consumingTxHash

string

Transaction ID that consumed this output.

transactions.emittedUtxos.createdOnChainId

string

required

Blockchain ID on which this output is created on.

transactions.emittedUtxos.utxoId

string

required

UTXO ID for this output.

transactions.emittedUtxos.amount

string

requireddeprecated

transactions.emittedUtxos.assetId

string

requireddeprecated

transactions.emittedUtxos.blockNumber

string

required

transactions.emittedUtxos.blockTimestamp

number

required

transactions.emittedUtxos.consumingBlockNumber

string

transactions.emittedUtxos.consumingBlockTimestamp

number

transactions.emittedUtxos.platformLocktime

number

transactions.emittedUtxos.outputIndex

number

required

transactions.emittedUtxos.rewardType

enum<string>

Available options:

VALIDATOR,

DELEGATOR,

VALIDATOR_FEE

transactions.emittedUtxos.stakeableLocktime

number

transactions.emittedUtxos.staked

boolean

transactions.emittedUtxos.threshold

number

transactions.emittedUtxos.txHash

string

required

transactions.emittedUtxos.utxoEndTimestamp

number

transactions.emittedUtxos.utxoStartTimestamp

number

transactions.emittedUtxos.utxoType

enum<string>

required

Available options:

STAKE,

TRANSFER

transactions.sourceChain

string

Source chain for an atomic transaction.

transactions.destinationChain

string

Destination chain for an atomic transaction.

transactions.value

object[]

required

A list of objects containing P-chain Asset basic info and the amount of that Asset ID.

Show child attributes

transactions.value.assetId

string

required

Unique ID for an asset.

transactions.value.name

string

required

Name of this asset.

transactions.value.symbol

string

required

Symbol for this asset (max 4 characters).

transactions.value.denomination

number

required

Denomination of this asset to represent fungibility.

transactions.value.type

enum<string>

required

Type of asset like SECP256K1 or NFT.

Available options:

secp256k1,

nft

transactions.value.amount

string

required

Amount of the asset.

transactions.amountBurned

object[]

required

A list of objects containing P-chain Asset basic info and the amount of that Asset ID.

Show child attributes

transactions.amountBurned.assetId

string

required

Unique ID for an asset.

transactions.amountBurned.name

string

required

Name of this asset.

transactions.amountBurned.symbol

string

required

Symbol for this asset (max 4 characters).

transactions.amountBurned.denomination

number

required

Denomination of this asset to represent fungibility.

transactions.amountBurned.type

enum<string>

required

Type of asset like SECP256K1 or NFT.

Available options:

secp256k1,

nft

transactions.amountBurned.amount

string

required

Amount of the asset.

transactions.amountStaked

object[]

required

A list of objects containing P-chain Asset basic info and the amount of that Asset ID. Present for AddValidatorTx, AddPermissionlessValidatorTx, AddDelegatorTx

Show child attributes

transactions.amountStaked.assetId

string

required

Unique ID for an asset.

transactions.amountStaked.name

string

required

Name of this asset.

transactions.amountStaked.symbol

string

required

Symbol for this asset (max 4 characters).

transactions.amountStaked.denomination

number

required

Denomination of this asset to represent fungibility.

transactions.amountStaked.type

enum<string>

required

Type of asset like SECP256K1 or NFT.

Available options:

secp256k1,

nft

transactions.amountStaked.amount

string

required

Amount of the asset.

transactions.amountL1ValidatorBalanceBurned

object[]

required

A list of objects containing P-chain Asset basic info and the amount of that Asset ID.

Show child attributes

transactions.amountL1ValidatorBalanceBurned.assetId

string

required

Unique ID for an asset.

transactions.amountL1ValidatorBalanceBurned.name

string

required

Name of this asset.

transactions.amountL1ValidatorBalanceBurned.symbol

string

required

Symbol for this asset (max 4 characters).

transactions.amountL1ValidatorBalanceBurned.denomination

number

required

Denomination of this asset to represent fungibility.

transactions.amountL1ValidatorBalanceBurned.type

enum<string>

required

Type of asset like SECP256K1 or NFT.

Available options:

secp256k1,

nft

transactions.amountL1ValidatorBalanceBurned.amount

string

required

Amount of the asset.

transactions.startTimestamp

number

Present for AddValidatorTx, AddSubnetValidatorTx, AddPermissionlessValidatorTx, AddDelegatorTx

transactions.endTimestamp

number

Present for AddValidatorTx, AddSubnetValidatorTx, AddPermissionlessValidatorTx, AddDelegatorTx

transactions.delegationFeePercent

string

Present for AddValidatorTx, AddPermissionlessValidatorTx

transactions.nodeId

string

Present for AddValidatorTx, AddSubnetValidatorTx, RemoveSubnetValidatorTx, AddPermissionlessValidatorTx, AddDelegatorTx

transactions.subnetId

string

Present for AddValidatorTx, AddSubnetValidatorTx, RemoveSubnetValidatorTx, AddPermissionlessValidatorTx, AddDelegatorTx, CreateChainTx, CreateSubnetTx

transactions.l1ValidatorManagerDetails

object

Details of the L1's validator manager contract and blockchain. Present for the ConvertSubnetToL1Tx which transforms a subnet into L1

Show child attributes

transactions.l1ValidatorManagerDetails.blockchainId

string

required

transactions.l1ValidatorManagerDetails.contractAddress

string

required

transactions.l1ValidatorDetails

object[]

Details of L1 validators registered or changed in the current transaction. The details reflect the state at the time of the transaction, not in real-time

Show child attributes

transactions.l1ValidatorDetails.validationId

string

required

Unique L1 validation ID used network-wide to identify L1 validation until its weight is reduced to 0 i.e. removed.

transactions.l1ValidatorDetails.nodeId

string

required

transactions.l1ValidatorDetails.subnetId

string

required

transactions.l1ValidatorDetails.weight

number

required

Weight of the L1 validator used while sampling validators within the L1. A zero-weight L1 validator means it has been removed from the L1, and the validationID is no longer valid

transactions.l1ValidatorDetails.remainingBalance

number

required

Remaining L1 validator balance in nAVAX until inactive. It can rejoin L1 sampling by increasing balance with IncreaseL1ValidatorBalanceTx

transactions.l1ValidatorDetails.balanceChange

number

The increase in L1 validator balance in the current transaction. When the balance is returned after the L1 validator is disabled or removed, this value is negative

transactions.l1ValidatorDetails.blsCredentials

object

transactions.estimatedReward

string

Present for AddValidatorTx, AddPermissionlessValidatorTx, AddDelegatorTx

transactions.rewardTxHash

string

transactions.rewardAddresses

string[]

transactions.memo

string

transactions.stakingTxHash

string

Present for RewardValidatorTx

transactions.subnetOwnershipInfo

object

Subnet owner details for the CreateSubnetTx or TransferSubnetOwnershipTx

Show child attributes

transactions.subnetOwnershipInfo.locktime

number

required

Locktime in seconds after which Subnet owners can control this Subnet.

transactions.subnetOwnershipInfo.threshold

number

required

Minimum number of signatures required to sign the Subnet update transactions.

transactions.subnetOwnershipInfo.addresses

string[]

required

Addresses that are eligible to sign the Subnet update transactions.

transactions.blsCredentials

object

Present for AddPermissionlessValidatorTx

Show child attributes

transactions.blsCredentials.publicKey

string

required

transactions.blsCredentials.proofOfPossession

string

required

chainInfo

object

required

Show child attributes

chainInfo.chainName

enum<string>

required

Available options:

p-chain,

x-chain,

c-chain

chainInfo.network

enum<string>

required

Available options:

mainnet,

fuji,

testnet,

devnet

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.