> ## Documentation Index
> Fetch the complete documentation index at: https://developers.avacloud.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Get transaction
> Gets the details of a single transaction on one of the Primary Network chains.
## OpenAPI
````yaml get /v1/networks/{network}/blockchains/{blockchainId}/transactions/{txHash}
openapi: 3.1.0
info:
title: Data API
description: >-
The Data API provides web3 application developers with multi-chain data
related to Avalanche's primary network, Avalanche subnets, and Ethereum.
With Data API, you can easily build products that leverage real-time and
historical transaction and transfer history, native and token balances, and
various types of token metadata. The API is in Beta and may be subject to
change.If you have feedback or feature requests for the API,
please submit them here.
Bug reports can be submitted here,
and any potential security issues can be reported here.
version: 1.0.0
contact: {}
servers:
- url: https://glacier-api.avax.network
security:
- apiKey: []
- {}
tags:
- name: EVM Chains
description: >-
Find information about indexed EVM-compatible chains, such as the
Avalanche C-Chain.
- name: EVM Blocks
description: >-
Find information about blocks on EVM-compatible chains, such as the
Avalanche C-Chain.
- name: EVM Transactions
description: >-
Find information about transactions on EVM-compatible chains, such as the
Avalanche C-Chain.
- name: EVM Balances
description: >-
Find information about balances on EVM-compatible chains, such as the
Avalanche C-Chain.
- name: EVM Contracts
description: >-
Find information about contracts on EVM-compatible chains, such as the
Avalanche C-Chain.
- name: Primary Network
- name: Primary Network Blocks
description: >-
Find information about blocks on Avalanche's Primary Network Chains - the
P-Chain, the X-Chain, and the C-Chain.
- name: Primary Network Vertices
description: Find information about vertices on Avalanche's X-Chain.
- name: Primary Network Transactions
description: >-
Find information about transactions on Avalanche's Primary Network Chains
- the P-Chain, the X-Chain, and the C-Chain.
- name: Primary Network Balances
description: >-
Find information about balances on Avalanche's Primary Network Chains -
the P-Chain, the X-Chain, and the C-Chain.
- name: Primary Network UTXOs
description: >-
Find information about utxos on Avalanche's Primary Network Chains - the
P-Chain, the X-Chain, and the C-Chain.
- name: Primary Network Rewards
description: Find information about rewards on Avalanche's Primary Network.
- name: NFTs
- name: Operations
- name: Health Check
- name: Teleporter
description: Find information about Teleporter transactions.
- name: Interchain Messaging
description: Find information about Interchain Messaging transactions.
- name: Webhooks
description: Manage webhooks and get notified for various onchain activities.
- name: RPC
description: Interact with chain nodes using JSON-RPC.
- name: Data API Usage Metrics
description: Usage metrics and logs for the Data API.
- name: Signature Aggregator
description: Request signatures for a Warp message from Subnet validators
- name: Notifications
description: Get notifications for validator status and activity issues.
- name: AVAX Supply
description: Find information about AVAX supply.
paths:
/v1/networks/{network}/blockchains/{blockchainId}/transactions/{txHash}:
get:
tags:
- Primary Network Transactions
summary: Get transaction
description: >-
Gets the details of a single transaction on one of the Primary Network
chains.
operationId: getTxByHash
parameters:
- name: blockchainId
required: true
in: path
description: A primary network blockchain id or alias.
example: p-chain
schema:
$ref: '#/components/schemas/BlockchainId'
- name: network
required: true
in: path
description: Either mainnet or testnet/fuji.
example: mainnet
schema:
$ref: '#/components/schemas/Network'
- name: txHash
required: true
in: path
description: A primary network (P or X chain) transaction hash.
example: 3P91K6nuDFvDodcRuJTsgdf9SvYe5pMiKk38HppsoeAiEztCP
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/PChainTransaction'
- $ref: '#/components/schemas/XChainNonLinearTransaction'
- $ref: '#/components/schemas/XChainLinearTransaction'
- $ref: '#/components/schemas/CChainExportTransaction'
- $ref: '#/components/schemas/CChainImportTransaction'
'400':
description: |-
Bad requests generally mean the client has passed invalid
or malformed parameters. Error messages in the response could help in
evaluating the error.
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequest'
'401':
description: |-
When a client attempts to access resources that require
authorization credentials but the client lacks proper authentication
in the request, the server responds with 401.
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
'403':
description: |-
When a client attempts to access resources with valid
credentials but doesn't have the privilege to perform that action,
the server responds with 403.
content:
application/json:
schema:
$ref: '#/components/schemas/Forbidden'
'404':
description: |-
The error is mostly returned when the client requests
with either mistyped URL, or the passed resource is moved or deleted,
or the resource doesn't exist.
content:
application/json:
schema:
$ref: '#/components/schemas/NotFound'
'429':
description: |-
This error is returned when the client has sent too many,
and has hit the rate limit.
content:
application/json:
schema:
$ref: '#/components/schemas/TooManyRequests'
'500':
description: |-
The error is a generic server side error that is
returned for any uncaught and unexpected issues on the server side.
This should be very rare, and you may reach out to us if the problem
persists for a longer duration.
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerError'
'502':
description: |-
This is an internal error indicating invalid response
received by the client-facing proxy or gateway from the upstream server.
content:
application/json:
schema:
$ref: '#/components/schemas/BadGateway'
'503':
description: |-
The error is returned for certain routes on a particular
Subnet. This indicates an internal problem with our Subnet node, and may
not necessarily mean the Subnet is down or affected.
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceUnavailable'
x-codeSamples:
- lang: javascript
label: JavaScript
source: |-
import { Avalanche } from "@avalanche-sdk/chainkit";
const avalanche = new Avalanche({
network: "mainnet",
});
async function run() {
const result = await avalanche.data.primaryNetwork.transactions.get({
blockchainId: "p-chain",
txHash: "3P91K6nuDFvDodcRuJTsgdf9SvYe5pMiKk38HppsoeAiEztCP",
});
console.log(result);
}
run();
components:
schemas:
BlockchainId:
type: string
enum:
- 11111111111111111111111111111111LpoYY
- 2oYMBNV4eNHyqk2fjjV5nVQLDbtmNJzq5s3qs3Lo6ftnC6FByM
- 2JVSBoinj9C2J33VntvzYtVJNZdN2NKiwwKjcumHUWEb5DbBrm
- 2q9e4r6Mu3U68nU1fYjgbR6JvwrRx36CohpAX5UQxse55x1Q5
- yH8D7ThNJkxmtkuv2jgBa4P1Rn3Qpr4pPr7QYNfcdoS6k6HWp
- p-chain
- x-chain
- c-chain
Network:
type: string
enum:
- mainnet
- fuji
- testnet
PChainTransaction:
type: object
properties:
txHash:
type: string
description: A P-Chain transaction hash.
examples:
- 3P91K6nuDFvDodcRuJTsgdf9SvYe5pMiKk38HppsoeAiEztCP
txType:
$ref: '#/components/schemas/PChainTransactionType'
examples:
- AddDelegatorTx
blockTimestamp:
type: number
description: The block finality timestamp.
examples:
- 1648672486
blockNumber:
type: string
description: The height of the block in which the transaction was included
blockHash:
type: string
consumedUtxos:
description: The consumed UTXOs of the transaction
type: array
items:
$ref: '#/components/schemas/PChainUtxo'
emittedUtxos:
description: The newly created UTXOs of the transaction
type: array
items:
$ref: '#/components/schemas/PChainUtxo'
sourceChain:
type: string
description: Source chain for an atomic transaction.
examples:
- 2oYMBNV4eNHyqk2fjjV5nVQLDbtmNJzq5s3qs3Lo6ftnC6FByM
destinationChain:
type: string
description: Destination chain for an atomic transaction.
examples:
- 2oYMBNV4eNHyqk2fjjV5nVQLDbtmNJzq5s3qs3Lo6ftnC6FByM
value:
description: >-
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
type: array
items:
$ref: '#/components/schemas/AssetAmount'
amountBurned:
description: >-
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
type: array
items:
$ref: '#/components/schemas/AssetAmount'
amountStaked:
description: >-
A list of objects containing P-chain Asset basic info and the amount
of that Asset ID. Present for AddValidatorTx,
AddPermissionlessValidatorTx, AddDelegatorTx
type: array
items:
$ref: '#/components/schemas/AssetAmount'
amountL1ValidatorBalanceBurned:
description: >-
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.
type: array
items:
$ref: '#/components/schemas/AssetAmount'
startTimestamp:
type: number
description: >-
Present for AddValidatorTx, AddSubnetValidatorTx,
AddPermissionlessValidatorTx, AddDelegatorTx
endTimestamp:
type: number
description: >-
Present for AddValidatorTx, AddSubnetValidatorTx,
AddPermissionlessValidatorTx, AddDelegatorTx
delegationFeePercent:
type: string
description: >-
The percentage of total estimated delegator rewards allocated to
validator nodes for supporting delegations. Present for
AddValidatorTx, AddPermissionlessValidatorTx
nodeId:
type: string
description: >-
The NodeID of the validator node linked to the stake transaction.
Present for AddValidatorTx, AddSubnetValidatorTx,
RemoveSubnetValidatorTx, AddPermissionlessValidatorTx,
AddDelegatorTx
subnetId:
type: string
description: >-
Present for AddValidatorTx, AddSubnetValidatorTx,
RemoveSubnetValidatorTx, AddPermissionlessValidatorTx,
AddDelegatorTx, CreateChainTx, CreateSubnetTx
l1ValidatorManagerDetails:
description: >-
Details of the L1's validator manager contract and blockchain.
Present for the ConvertSubnetToL1Tx which transforms a subnet into
L1
allOf:
- $ref: '#/components/schemas/L1ValidatorManagerDetails'
l1ValidatorDetails:
description: >-
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
type: array
items:
$ref: '#/components/schemas/L1ValidatorDetailsTransaction'
estimatedReward:
type: string
description: >-
Estimated reward from the staking transaction, if successful.
Present for AddValidatorTx, AddPermissionlessValidatorTx,
AddDelegatorTx
rewardTxHash:
type: string
description: Reward transaction hash for the completed validations or delegations
rewardAddresses:
type: array
items:
type: string
memo:
type: string
stakingTxHash:
type: string
description: Staking transaction corresponding to the RewardValidatorTx
subnetOwnershipInfo:
description: >-
Subnet owner details for the CreateSubnetTx or
TransferSubnetOwnershipTx
allOf:
- $ref: '#/components/schemas/SubnetOwnershipInfo'
blsCredentials:
description: >-
Public Key and PoP of new validator registrations. Present for
AddPermissionlessValidatorTx
allOf:
- $ref: '#/components/schemas/BlsCredentials'
blockchainInfo:
description: Details of the blockchain that was created in the CreateChainTx
allOf:
- $ref: '#/components/schemas/BlockchainInfo'
required:
- txHash
- txType
- blockTimestamp
- blockNumber
- blockHash
- consumedUtxos
- emittedUtxos
- value
- amountBurned
- amountStaked
- amountL1ValidatorBalanceBurned
XChainNonLinearTransaction:
type: object
properties:
txHash:
type: string
description: Unique ID for this transaction.
examples:
- 3j9JpF1aGuQtLLbo3YkvvKkWrCZViXZjdeJQWUSEY5hcqUn2c
chainFormat:
type: string
description: Represents chain format this transaction is included in.
enum:
- non-linear
- linear
examples:
- non-linear
timestamp:
type: number
description: >-
Latest timestamp in seconds this transaction was accepted out of the
same transaction accepted in other vertices.
examples:
- 1600762738
txType:
$ref: '#/components/schemas/XChainTransactionType'
examples:
- BaseTx
memo:
type: string
description: Hex encoded memo bytes for this transaction.
examples:
- '0x546865204176616c616e6368652050726f6a656374'
consumedUtxos:
type: array
items:
$ref: '#/components/schemas/Utxo'
emittedUtxos:
type: array
items:
$ref: '#/components/schemas/Utxo'
amountUnlocked:
description: Assets unlocked by inputs of this transaction.
type: array
items:
$ref: '#/components/schemas/AssetAmount'
amountCreated:
description: Assets created by outputs of this transaction.
type: array
items:
$ref: '#/components/schemas/AssetAmount'
sourceChain:
type: string
description: Source chain for an atomic transaction.
examples:
- 2oYMBNV4eNHyqk2fjjV5nVQLDbtmNJzq5s3qs3Lo6ftnC6FByM
destinationChain:
type: string
description: Destination chain for an atomic transaction.
examples:
- 2oYMBNV4eNHyqk2fjjV5nVQLDbtmNJzq5s3qs3Lo6ftnC6FByM
assetCreated:
description: AssetAmount details of the asset created in CreateAssetTx
allOf:
- $ref: '#/components/schemas/XChainAssetDetails'
vertices:
description: A transaction on X-Chain can be accepted over multiple vertices.
type: array
items:
$ref: '#/components/schemas/TransactionVertexDetail'
required:
- txHash
- chainFormat
- timestamp
- txType
- memo
- consumedUtxos
- emittedUtxos
- amountUnlocked
- amountCreated
- vertices
XChainLinearTransaction:
type: object
properties:
txHash:
type: string
description: Unique ID for this transaction.
examples:
- 3j9JpF1aGuQtLLbo3YkvvKkWrCZViXZjdeJQWUSEY5hcqUn2c
chainFormat:
type: string
description: Represents chain format this transaction is included in.
enum:
- non-linear
- linear
examples:
- non-linear
timestamp:
type: number
description: >-
Latest timestamp in seconds this transaction was accepted out of the
same transaction accepted in other vertices.
examples:
- 1600762738
txType:
$ref: '#/components/schemas/XChainTransactionType'
examples:
- BaseTx
memo:
type: string
description: Hex encoded memo bytes for this transaction.
examples:
- '0x546865204176616c616e6368652050726f6a656374'
consumedUtxos:
type: array
items:
$ref: '#/components/schemas/Utxo'
emittedUtxos:
type: array
items:
$ref: '#/components/schemas/Utxo'
amountUnlocked:
description: Assets unlocked by inputs of this transaction.
type: array
items:
$ref: '#/components/schemas/AssetAmount'
amountCreated:
description: Assets created by outputs of this transaction.
type: array
items:
$ref: '#/components/schemas/AssetAmount'
sourceChain:
type: string
description: Source chain for an atomic transaction.
examples:
- 2oYMBNV4eNHyqk2fjjV5nVQLDbtmNJzq5s3qs3Lo6ftnC6FByM
destinationChain:
type: string
description: Destination chain for an atomic transaction.
examples:
- 2oYMBNV4eNHyqk2fjjV5nVQLDbtmNJzq5s3qs3Lo6ftnC6FByM
assetCreated:
description: AssetAmount details of the asset created in CreateAssetTx
allOf:
- $ref: '#/components/schemas/XChainAssetDetails'
blockHeight:
type: number
description: Height of the block this transaction belongs to.
examples:
- 1005
blockHash:
type: string
description: Hash of the block this transaction belongs to.
examples:
- 82qPRREHmh8Cfta4PGD6GymY9ZLyvgYugqW6hj9FykpMVRz1S
required:
- txHash
- chainFormat
- timestamp
- txType
- memo
- consumedUtxos
- emittedUtxos
- amountUnlocked
- amountCreated
- blockHeight
- blockHash
CChainExportTransaction:
type: object
properties:
txHash:
type: string
description: Unique ID for this transaction.
examples:
- 3j9JpF1aGuQtLLbo3YkvvKkWrCZViXZjdeJQWUSEY5hcqUn2c
blockHeight:
type: number
description: Height of the block this transaction belongs to.
examples:
- 1005
blockHash:
type: string
description: Hash of the block this transaction belongs to.
examples:
- '0x57a5cb7704561d1d59bd563b6421021b7563960c05ba3ae0e36fc36917c742ee'
timestamp:
type: number
description: Latest timestamp in seconds this transaction was accepted.
examples:
- 1600762738
memo:
type: string
description: Hex encoded memo bytes for this transaction.
examples:
- '0x546865204176616c616e6368652050726f6a656374'
amountUnlocked:
description: Assets unlocked by inputs of this transaction.
type: array
items:
$ref: '#/components/schemas/AssetAmount'
amountCreated:
description: Assets created by outputs of this transaction.
type: array
items:
$ref: '#/components/schemas/AssetAmount'
sourceChain:
type: string
description: Source chain for an atomic transaction.
examples:
- 2oYMBNV4eNHyqk2fjjV5nVQLDbtmNJzq5s3qs3Lo6ftnC6FByM
destinationChain:
type: string
description: Destination chain for an atomic transaction.
examples:
- 2oYMBNV4eNHyqk2fjjV5nVQLDbtmNJzq5s3qs3Lo6ftnC6FByM
txType:
type: string
description: Type of transaction.
enum:
- ExportTx
examples:
- ExportTx
evmInputs:
type: array
items:
$ref: '#/components/schemas/EVMInput'
emittedUtxos:
type: array
items:
$ref: '#/components/schemas/Utxo'
required:
- txHash
- blockHeight
- blockHash
- timestamp
- memo
- amountUnlocked
- amountCreated
- sourceChain
- destinationChain
- txType
- evmInputs
- emittedUtxos
CChainImportTransaction:
type: object
properties:
txHash:
type: string
description: Unique ID for this transaction.
examples:
- 3j9JpF1aGuQtLLbo3YkvvKkWrCZViXZjdeJQWUSEY5hcqUn2c
blockHeight:
type: number
description: Height of the block this transaction belongs to.
examples:
- 1005
blockHash:
type: string
description: Hash of the block this transaction belongs to.
examples:
- '0x57a5cb7704561d1d59bd563b6421021b7563960c05ba3ae0e36fc36917c742ee'
timestamp:
type: number
description: Latest timestamp in seconds this transaction was accepted.
examples:
- 1600762738
memo:
type: string
description: Hex encoded memo bytes for this transaction.
examples:
- '0x546865204176616c616e6368652050726f6a656374'
amountUnlocked:
description: Assets unlocked by inputs of this transaction.
type: array
items:
$ref: '#/components/schemas/AssetAmount'
amountCreated:
description: Assets created by outputs of this transaction.
type: array
items:
$ref: '#/components/schemas/AssetAmount'
sourceChain:
type: string
description: Source chain for an atomic transaction.
examples:
- 2oYMBNV4eNHyqk2fjjV5nVQLDbtmNJzq5s3qs3Lo6ftnC6FByM
destinationChain:
type: string
description: Destination chain for an atomic transaction.
examples:
- 2oYMBNV4eNHyqk2fjjV5nVQLDbtmNJzq5s3qs3Lo6ftnC6FByM
txType:
type: string
description: Type of transaction.
enum:
- ImportTx
examples:
- ImportTx
evmOutputs:
type: array
items:
$ref: '#/components/schemas/EVMOutput'
consumedUtxos:
type: array
items:
$ref: '#/components/schemas/Utxo'
required:
- txHash
- blockHeight
- blockHash
- timestamp
- memo
- amountUnlocked
- amountCreated
- sourceChain
- destinationChain
- txType
- evmOutputs
- consumedUtxos
BadRequest:
type: object
properties:
message:
description: The error message describing the reason for the exception
oneOf:
- type: string
- type: array
items:
type: string
statusCode:
type: number
description: The HTTP status code of the response
examples:
- 400
error:
type: string
description: The type of error
examples:
- Bad Request
required:
- message
- statusCode
- error
Unauthorized:
type: object
properties:
message:
description: The error message describing the reason for the exception
oneOf:
- type: string
- type: array
items:
type: string
statusCode:
type: number
description: The HTTP status code of the response
examples:
- 401
error:
type: string
description: The type of error
examples:
- Unauthorized
required:
- message
- statusCode
- error
Forbidden:
type: object
properties:
message:
description: The error message describing the reason for the exception
oneOf:
- type: string
- type: array
items:
type: string
statusCode:
type: number
description: The HTTP status code of the response
examples:
- 403
error:
type: string
description: The type of error
examples:
- Forbidden
required:
- message
- statusCode
- error
NotFound:
type: object
properties:
message:
description: The error message describing the reason for the exception
oneOf:
- type: string
- type: array
items:
type: string
statusCode:
type: number
description: The HTTP status code of the response
examples:
- 404
error:
type: string
description: The type of error
examples:
- Not Found
required:
- message
- statusCode
- error
TooManyRequests:
type: object
properties:
message:
description: The error message describing the reason for the exception
oneOf:
- type: string
- type: array
items:
type: string
statusCode:
type: number
description: The HTTP status code of the response
examples:
- 429
error:
type: string
description: The type of error
examples:
- Too Many Requests
required:
- message
- statusCode
- error
InternalServerError:
type: object
properties:
message:
description: The error message describing the reason for the exception
oneOf:
- type: string
- type: array
items:
type: string
statusCode:
type: number
description: The HTTP status code of the response
examples:
- 500
error:
type: string
description: The type of error
examples:
- Internal Server Error
required:
- message
- statusCode
- error
BadGateway:
type: object
properties:
message:
description: The error message describing the reason for the exception
oneOf:
- type: string
- type: array
items:
type: string
statusCode:
type: number
description: The HTTP status code of the response
examples:
- 502
error:
type: string
description: The type of error
examples:
- Bad Gateway
required:
- message
- statusCode
- error
ServiceUnavailable:
type: object
properties:
message:
description: The error message describing the reason for the exception
oneOf:
- type: string
- type: array
items:
type: string
statusCode:
type: number
description: The HTTP status code of the response
examples:
- 503
error:
type: string
description: The type of error
examples:
- Service Unavailable
required:
- message
- statusCode
- error
PChainTransactionType:
type: string
enum:
- AddValidatorTx
- AddSubnetValidatorTx
- AddDelegatorTx
- CreateChainTx
- CreateSubnetTx
- ImportTx
- ExportTx
- AdvanceTimeTx
- RewardValidatorTx
- RemoveSubnetValidatorTx
- TransformSubnetTx
- AddPermissionlessValidatorTx
- AddPermissionlessDelegatorTx
- BaseTx
- TransferSubnetOwnershipTx
- ConvertSubnetToL1Tx
- RegisterL1ValidatorTx
- SetL1ValidatorWeightTx
- DisableL1ValidatorTx
- IncreaseL1ValidatorBalanceTx
- UNKNOWN
PChainUtxo:
type: object
properties:
addresses:
description: Addresses that are eligible to sign the consumption of this output.
examples:
- - avax1qm2a25eytsrj235hxg6jc0mwk99tss64eqevsw
type: array
items:
type: string
asset:
$ref: '#/components/schemas/AssetAmount'
consumedOnChainId:
type: string
description: Blockchain ID on which this output is consumed on.
examples:
- 2oYMBNV4eNHyqk2fjjV5nVQLDbtmNJzq5s3qs3Lo6ftnC6FByM
consumingTxHash:
type: string
description: Transaction ID that consumed this output.
examples:
- 3j9JpF1aGuQtLLbo3YkvvKkWrCZViXZjdeJQWUSEY5hcqUn2c
createdOnChainId:
type: string
description: Blockchain ID on which this output is created on.
examples:
- 2oYMBNV4eNHyqk2fjjV5nVQLDbtmNJzq5s3qs3Lo6ftnC6FByM
utxoId:
type: string
description: UTXO ID for this output.
examples:
- 68vLva9kfKUsX88ZPM8jdbf8qHUZRoZSFH6NdpAVTspkfrXDC
utxoBytes:
type: string
description: The bytes of the UTXO
amount:
type: string
deprecated: true
assetId:
type: string
deprecated: true
blockNumber:
type: string
blockTimestamp:
type: number
consumingBlockNumber:
type: string
description: >-
Block height in which the transaction consuming this UTXO was
included
consumingBlockTimestamp:
type: number
description: >-
Timestamp in seconds at which this UTXO is used in a consuming
transaction
platformLocktime:
type: number
description: Timestamp in seconds after which this UTXO can be consumed
outputIndex:
type: number
description: The index of the UTXO in the transaction
rewardType:
$ref: '#/components/schemas/RewardType'
stakeableLocktime:
type: number
description: >-
Timestamp in seconds before which a UTXO can only be used for
staking transactions. After stakeable locktime, a UTXO can be used
for anything
staked:
type: boolean
threshold:
type: number
description: The minimum number of signatures required to spend this UTXO
txHash:
type: string
description: The hash of the transaction that created this UTXO
utxoEndTimestamp:
type: number
description: Timestamp in seconds after which the staked UTXO will be unlocked.
utxoStartTimestamp:
type: number
description: Timestamp in seconds at which the staked UTXO was locked.
utxoType:
$ref: '#/components/schemas/UtxoType'
required:
- addresses
- asset
- consumedOnChainId
- createdOnChainId
- utxoId
- amount
- assetId
- blockNumber
- blockTimestamp
- outputIndex
- txHash
- utxoType
AssetAmount:
type: object
properties:
assetId:
type: string
description: Unique ID for an asset.
examples:
- th5aLdWLi32yS9ED6uLGoMMubqHjzMsXhKWwzP6yZTYQKYzof
name:
type: string
description: Name of this asset.
examples:
- Avalanche
symbol:
type: string
description: Symbol for this asset (max 4 characters).
examples:
- AVAX
denomination:
type: number
description: Denomination of this asset to represent fungibility.
examples:
- 9
type:
$ref: '#/components/schemas/PrimaryNetworkAssetType'
examples:
- secp256k1
amount:
type: string
description: Amount of the asset.
examples:
- '5001000'
required:
- assetId
- name
- symbol
- denomination
- type
- amount
L1ValidatorManagerDetails:
type: object
properties:
blockchainId:
type: string
contractAddress:
type: string
required:
- blockchainId
- contractAddress
L1ValidatorDetailsTransaction:
type: object
properties:
validationId:
type: string
description: >-
Unique L1 validation ID used network-wide to identify L1 validation
until its weight is reduced to 0 i.e. removed.
validationIdHex:
type: string
description: >-
Unique L1 validation ID used network-wide to identify L1 validation
until its weight is reduced to 0 i.e. removed. In hex format
nodeId:
type: string
subnetId:
type: string
weight:
type: number
description: >-
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
remainingBalance:
type: number
description: >-
Remaining L1 validator balance in nAVAX until inactive. It can
rejoin L1 sampling by increasing balance with
IncreaseL1ValidatorBalanceTx
balanceChange:
type: number
description: >-
The increase in L1 validator balance (nAVAX) in the current
transaction. When the balance is returned after the L1 validator is
disabled or removed, this value is negative
blsCredentials:
type: object
required:
- validationId
- validationIdHex
- nodeId
- subnetId
- weight
- remainingBalance
SubnetOwnershipInfo:
type: object
properties:
locktime:
type: number
description: >-
Locktime in seconds after which Subnet owners can control this
Subnet.
examples:
- 0
threshold:
type: number
description: >-
Minimum number of signatures required to sign the Subnet update
transactions.
examples:
- 1
addresses:
description: Addresses that are eligible to sign the Subnet update transactions.
examples:
- - avax1qm2a25eytsrj235hxg6jc0mwk99tss64eqevsw
type: array
items:
type: string
required:
- locktime
- threshold
- addresses
BlsCredentials:
type: object
properties:
publicKey:
type: string
proofOfPossession:
type: string
required:
- publicKey
- proofOfPossession
BlockchainInfo:
type: object
properties:
chainName:
type: string
vmId:
type: string
genesisData:
type: object
description: >-
The genesis data of the blockchain. Present for CreateChainTx. EVM
based chains will return the genesis data as an object. Non-EVM
based chains will return the genesis data as an encoded string. The
encoding depends on the VM
required:
- chainName
- vmId
XChainTransactionType:
type: string
description: Type of transaction.
enum:
- BaseTx
- CreateAssetTx
- OperationTx
- ImportTx
- ExportTx
- UNKNOWN
Utxo:
type: object
properties:
addresses:
description: Addresses that are eligible to sign the consumption of this output.
examples:
- - avax1qm2a25eytsrj235hxg6jc0mwk99tss64eqevsw
type: array
items:
type: string
asset:
$ref: '#/components/schemas/AssetAmount'
consumedOnChainId:
type: string
description: Blockchain ID on which this output is consumed on.
examples:
- 2oYMBNV4eNHyqk2fjjV5nVQLDbtmNJzq5s3qs3Lo6ftnC6FByM
consumingTxHash:
type: string
description: Transaction ID that consumed this output.
examples:
- 3j9JpF1aGuQtLLbo3YkvvKkWrCZViXZjdeJQWUSEY5hcqUn2c
createdOnChainId:
type: string
description: Blockchain ID on which this output is created on.
examples:
- 2oYMBNV4eNHyqk2fjjV5nVQLDbtmNJzq5s3qs3Lo6ftnC6FByM
utxoId:
type: string
description: UTXO ID for this output.
examples:
- 68vLva9kfKUsX88ZPM8jdbf8qHUZRoZSFH6NdpAVTspkfrXDC
utxoBytes:
type: string
description: The bytes of the UTXO
consumingTxTimestamp:
type: number
description: Unix timestamp in seconds at which this output was consumed.
examples:
- 1599696000
creationTxHash:
type: string
description: Transaction ID that created this output.
examples:
- FvwEAhmxKfeiG8SnEvq42hc6whRyY3EFYAvebMqDNDGCgxN5Z
credentials:
description: Credentials that signed the transaction to consume this utxo
type: array
items:
$ref: '#/components/schemas/UtxoCredential'
groupId:
type: number
description: Index representing the minting set for the NFT mint output.
locktime:
type: number
description: Locktime in seconds after which this output can be consumed.
examples:
- 0
outputIndex:
type: string
description: >-
Postion of this output in a list of lexiographically sorted outputs
of a transaction.
examples:
- '38'
payload:
type: string
description: Hex encoded data for NFT assets.
threshold:
type: number
description: Minimum number of signatures required to consume this output.
examples:
- 1
timestamp:
type: number
description: Unix timestamp in seconds at which this outptut was created.
examples:
- 1599696000
utxoType:
type: string
description: Type of output.
examples:
- mint
required:
- addresses
- asset
- consumedOnChainId
- createdOnChainId
- utxoId
- creationTxHash
- locktime
- outputIndex
- threshold
- timestamp
- utxoType
XChainAssetDetails:
type: object
properties:
assetId:
type: string
description: Unique ID for an asset.
examples:
- th5aLdWLi32yS9ED6uLGoMMubqHjzMsXhKWwzP6yZTYQKYzof
name:
type: string
description: Name of this asset.
examples:
- Avalanche
symbol:
type: string
description: Symbol for this asset (max 4 characters).
examples:
- AVAX
denomination:
type: number
description: Denomination of this asset to represent fungibility.
examples:
- 9
type:
$ref: '#/components/schemas/PrimaryNetworkAssetType'
examples:
- secp256k1
createdAtTimestamp:
type: number
description: Timestamp in seconds this asset was created on.
examples:
- 1675444720
cap:
$ref: '#/components/schemas/PrimaryNetworkAssetCap'
examples:
- fixed
required:
- assetId
- name
- symbol
- denomination
- type
- createdAtTimestamp
- cap
TransactionVertexDetail:
type: object
properties:
hash:
type: string
description: Vertex ID of the vertex this transaction belongs to.
examples:
- 82qPRREHmh8Cfta4PGD6GymY9ZLyvgYugqW6hj9FykpMVRz1S
height:
type: number
description: Vertex height of the vertex this transaction belongs to.
examples:
- 1961
timestamp:
type: number
description: Timestamp in seconds this vertex was accepted.
examples:
- 1600762738
required:
- hash
- height
- timestamp
EVMInput:
type: object
properties:
fromAddress:
type: string
description: EVM address from which the asset is exported in ExportTx.
examples:
- '0xD0f2898e49d941D6d479B381d3C8F0bd8d983b4c'
asset:
description: AssetAmount details for the asset being transferred.
allOf:
- $ref: '#/components/schemas/AssetAmount'
credentials:
description: Credentials that signed this transaction.
type: array
items:
$ref: '#/components/schemas/UtxoCredential'
required:
- fromAddress
- asset
- credentials
EVMOutput:
type: object
properties:
toAddress:
type: string
description: EVM address to which the asset is imported in ImportTx
examples:
- '0xD0f2898e49d941D6d479B381d3C8F0bd8d983b4c'
asset:
description: AssetAmount details for the asset being transferred.
allOf:
- $ref: '#/components/schemas/AssetAmount'
required:
- toAddress
- asset
RewardType:
type: string
enum:
- VALIDATOR
- DELEGATOR
- VALIDATOR_FEE
UtxoType:
type: string
description: Indicates whether the UTXO is staked or transferable
enum:
- STAKE
- TRANSFER
PrimaryNetworkAssetType:
type: string
description: Type of asset like SECP256K1 or NFT.
enum:
- secp256k1
- nft
UtxoCredential:
type: object
properties:
signature:
type: string
description: Signature provided to consume the output.
examples:
- >-
bWWoZUu0Z3STjuk/+2az7M4vP0oqc9NtiA7kOdqINCIE/2+5va5R1KNCWwEX5jE1xVHLvAxU2LHTN5gK8m84HwA
publicKey:
type: string
description: Public key associated with the signature.
examples:
- AdMQOtubgBFFJu++0faHPIIA6KmdZ2ERErMRGzyy6juI
PrimaryNetworkAssetCap:
type: string
description: Cap represents if an asset is a variable or fixed cap asset.
enum:
- fixed
- variable
securitySchemes:
apiKey:
type: apiKey
in: header
name: x-glacier-api-key
description: >-
Api keys provide higher access to rate limits. To obtain an api key,
sign up for an account at https://avacloud.io/.
````