GET
/
v1
/
networks
/
{network}
/
blockchains
/
{blockchainId}
/
transactions
/
{txHash}
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.getTxByHash({
    blockchainId: "p-chain",
    network: "mainnet",
    txHash: "3P91K6nuDFvDodcRuJTsgdf9SvYe5pMiKk38HppsoeAiEztCP",
  });

  // Handle the result
  console.log(result);
}

run();
{
  "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>"
  }
}

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
txHash
string
required

A primary network (P or X chain) transaction hash.

Response

200
application/json
Successful response
txHash
string
required

A P-Chain transaction hash.

Example:

"3P91K6nuDFvDodcRuJTsgdf9SvYe5pMiKk38HppsoeAiEztCP"

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
blockTimestamp
number
required

The block finality timestamp.

Example:

1648672486

blockNumber
string
required

The height of the block in which the transaction was included

blockHash
string
required
consumedUtxos
object[]
required

The consumed UTXOs of the transaction

emittedUtxos
object[]
required

The newly created UTXOs of the transaction

value
object[]
required

A list of objects containing P-chain Asset basic info and the amount of that Asset ID. The amount of nAVAX present in the newly created UTXOs of the transaction

amountBurned
object[]
required

A list of objects containing P-chain Asset basic info and the amount of that Asset ID. The nAVAX amount burned in a transaction, partially or fully contributing to the transaction fee

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

amountL1ValidatorBalanceBurned
object[]
required

A list of objects containing P-chain Asset basic info and the amount of that Asset ID. The amount of nAVAX locked for pay-as-you-go continuous fees to sustain L1 validation.

sourceChain
string

Source chain for an atomic transaction.

Example:

"2oYMBNV4eNHyqk2fjjV5nVQLDbtmNJzq5s3qs3Lo6ftnC6FByM"

destinationChain
string

Destination chain for an atomic transaction.

Example:

"2oYMBNV4eNHyqk2fjjV5nVQLDbtmNJzq5s3qs3Lo6ftnC6FByM"

startTimestamp
number

Present for AddValidatorTx, AddSubnetValidatorTx, AddPermissionlessValidatorTx, AddDelegatorTx

endTimestamp
number

Present for AddValidatorTx, AddSubnetValidatorTx, AddPermissionlessValidatorTx, AddDelegatorTx

delegationFeePercent
string

The percentage of total estimated delegator rewards allocated to validator nodes for supporting delegations. Present for AddValidatorTx, AddPermissionlessValidatorTx

nodeId
string

The NodeID of the validator node linked to the stake transaction. Present for AddValidatorTx, AddSubnetValidatorTx, RemoveSubnetValidatorTx, AddPermissionlessValidatorTx, AddDelegatorTx

subnetId
string

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

l1ValidatorManagerDetails
object

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

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

estimatedReward
string

Estimated reward from the staking transaction, if successful. Present for AddValidatorTx, AddPermissionlessValidatorTx, AddDelegatorTx

rewardTxHash
string

Reward transaction hash for the completed validations or delegations

rewardAddresses
string[]
memo
string
stakingTxHash
string

Staking transaction corresponding to the RewardValidatorTx

subnetOwnershipInfo
object

Subnet owner details for the CreateSubnetTx or TransferSubnetOwnershipTx

blsCredentials
object

Public Key and PoP of new validator registrations. Present for AddPermissionlessValidatorTx