GET
/
v1
/
networks
/
{network}
/
blockchains
/
{blockchainId}
/
transactions
import { AvaCloudSDK } from "@avalabs/avacloud-sdk";

const avaCloudSDK = new AvaCloudSDK({
  serverURL: "https://api.example.com",
  chainId: "43114",
  network: "mainnet",
});

async function run() {
  const result = await avaCloudSDK.data.primaryNetwork.transactions.listLatestPrimaryNetworkTransactions({
    addresses: "avax1h2ccj9f5ay5acl6tyn9mwmw32p8wref8vl8ctg",
    txTypes: [
      "AddValidatorTx",
    ],
    startTimestamp: 1689541049,
    endTimestamp: 1689800249,
    blockchainId: "p-chain",
    network: "mainnet",
    sortOrder: "asc",
  });

  for await (const page of result) {
    // Handle the page
    console.log(page);
  }
}

run();
{
  "nextPageToken": "<string>",
  "transactions": [
    {
      "txHash": "3P91K6nuDFvDodcRuJTsgdf9SvYe5pMiKk38HppsoeAiEztCP",
      "txType": "AddDelegatorTx",
      "blockTimestamp": 1648672486,
      "blockNumber": "<string>",
      "blockHash": "<string>",
      "consumedUtxos": [
        {
          "addresses": [
            "avax1qm2a25eytsrj235hxg6jc0mwk99tss64eqevsw"
          ],
          "asset": {
            "assetId": "th5aLdWLi32yS9ED6uLGoMMubqHjzMsXhKWwzP6yZTYQKYzof",
            "name": "Avalanche",
            "symbol": "AVAX",
            "denomination": 9,
            "type": "secp256k1",
            "amount": "5001000"
          },
          "consumedOnChainId": "2oYMBNV4eNHyqk2fjjV5nVQLDbtmNJzq5s3qs3Lo6ftnC6FByM",
          "consumingTxHash": "3j9JpF1aGuQtLLbo3YkvvKkWrCZViXZjdeJQWUSEY5hcqUn2c",
          "createdOnChainId": "2oYMBNV4eNHyqk2fjjV5nVQLDbtmNJzq5s3qs3Lo6ftnC6FByM",
          "utxoId": "68vLva9kfKUsX88ZPM8jdbf8qHUZRoZSFH6NdpAVTspkfrXDC",
          "amount": "<string>",
          "assetId": "<string>",
          "blockNumber": "<string>",
          "blockTimestamp": 123,
          "consumingBlockNumber": "<string>",
          "consumingBlockTimestamp": 123,
          "platformLocktime": 123,
          "outputIndex": 123,
          "rewardType": "VALIDATOR",
          "stakeableLocktime": 123,
          "staked": true,
          "threshold": 123,
          "txHash": "<string>",
          "utxoEndTimestamp": 123,
          "utxoStartTimestamp": 123,
          "utxoType": "STAKE"
        }
      ],
      "emittedUtxos": [
        {
          "addresses": [
            "avax1qm2a25eytsrj235hxg6jc0mwk99tss64eqevsw"
          ],
          "asset": {
            "assetId": "th5aLdWLi32yS9ED6uLGoMMubqHjzMsXhKWwzP6yZTYQKYzof",
            "name": "Avalanche",
            "symbol": "AVAX",
            "denomination": 9,
            "type": "secp256k1",
            "amount": "5001000"
          },
          "consumedOnChainId": "2oYMBNV4eNHyqk2fjjV5nVQLDbtmNJzq5s3qs3Lo6ftnC6FByM",
          "consumingTxHash": "3j9JpF1aGuQtLLbo3YkvvKkWrCZViXZjdeJQWUSEY5hcqUn2c",
          "createdOnChainId": "2oYMBNV4eNHyqk2fjjV5nVQLDbtmNJzq5s3qs3Lo6ftnC6FByM",
          "utxoId": "68vLva9kfKUsX88ZPM8jdbf8qHUZRoZSFH6NdpAVTspkfrXDC",
          "amount": "<string>",
          "assetId": "<string>",
          "blockNumber": "<string>",
          "blockTimestamp": 123,
          "consumingBlockNumber": "<string>",
          "consumingBlockTimestamp": 123,
          "platformLocktime": 123,
          "outputIndex": 123,
          "rewardType": "VALIDATOR",
          "stakeableLocktime": 123,
          "staked": true,
          "threshold": 123,
          "txHash": "<string>",
          "utxoEndTimestamp": 123,
          "utxoStartTimestamp": 123,
          "utxoType": "STAKE"
        }
      ],
      "sourceChain": "2oYMBNV4eNHyqk2fjjV5nVQLDbtmNJzq5s3qs3Lo6ftnC6FByM",
      "destinationChain": "2oYMBNV4eNHyqk2fjjV5nVQLDbtmNJzq5s3qs3Lo6ftnC6FByM",
      "value": [
        {
          "assetId": "th5aLdWLi32yS9ED6uLGoMMubqHjzMsXhKWwzP6yZTYQKYzof",
          "name": "Avalanche",
          "symbol": "AVAX",
          "denomination": 9,
          "type": "secp256k1",
          "amount": "5001000"
        }
      ],
      "amountBurned": [
        {
          "assetId": "th5aLdWLi32yS9ED6uLGoMMubqHjzMsXhKWwzP6yZTYQKYzof",
          "name": "Avalanche",
          "symbol": "AVAX",
          "denomination": 9,
          "type": "secp256k1",
          "amount": "5001000"
        }
      ],
      "amountStaked": [
        {
          "assetId": "th5aLdWLi32yS9ED6uLGoMMubqHjzMsXhKWwzP6yZTYQKYzof",
          "name": "Avalanche",
          "symbol": "AVAX",
          "denomination": 9,
          "type": "secp256k1",
          "amount": "5001000"
        }
      ],
      "amountL1ValidatorBalanceBurned": [
        {
          "assetId": "th5aLdWLi32yS9ED6uLGoMMubqHjzMsXhKWwzP6yZTYQKYzof",
          "name": "Avalanche",
          "symbol": "AVAX",
          "denomination": 9,
          "type": "secp256k1",
          "amount": "5001000"
        }
      ],
      "startTimestamp": 123,
      "endTimestamp": 123,
      "delegationFeePercent": "<string>",
      "nodeId": "<string>",
      "subnetId": "<string>",
      "l1ValidatorManagerDetails": {
        "blockchainId": "<string>",
        "contractAddress": "<string>"
      },
      "l1ValidatorDetails": [
        {
          "validationId": "<string>",
          "nodeId": "<string>",
          "subnetId": "<string>",
          "weight": 123,
          "remainingBalance": 123,
          "balanceChange": 123,
          "blsCredentials": {}
        }
      ],
      "estimatedReward": "<string>",
      "rewardTxHash": "<string>",
      "rewardAddresses": [
        "<string>"
      ],
      "memo": "<string>",
      "stakingTxHash": "<string>",
      "subnetOwnershipInfo": {
        "locktime": 0,
        "threshold": 1,
        "addresses": [
          "avax1qm2a25eytsrj235hxg6jc0mwk99tss64eqevsw"
        ]
      },
      "blsCredentials": {
        "publicKey": "<string>",
        "proofOfPossession": "<string>"
      }
    }
  ],
  "chainInfo": {
    "chainName": "p-chain",
    "network": "mainnet"
  }
}

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

​
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
Successful response
​
transactions
object[]
required
​
chainInfo
object
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.

Was this page helpful?