Granite Upgrade Activates in11d:16h:53m:08s
Transactions

List asset transactions

Lists asset transactions corresponding to the given asset id on the X-Chain.

GET
/v1/networks/{network}/blockchains/{blockchainId}/assets/{assetId}/transactions
x-glacier-api-key<token>

Api keys provide higher access to rate limits. To obtain an api key, sign up for an account at https://build.avax.network/console/utilities/data-api-keys.

In: header

Path Parameters

blockchainIdstring

A primary network blockchain id or alias.

Value in"2oYMBNV4eNHyqk2fjjV5nVQLDbtmNJzq5s3qs3Lo6ftnC6FByM" | "2JVSBoinj9C2J33VntvzYtVJNZdN2NKiwwKjcumHUWEb5DbBrm" | "x-chain"
networkstring

Either mainnet or testnet/fuji.

Value in"mainnet" | "fuji" | "testnet"
assetIdstring

Asset ID for any asset on X-Chain

Query Parameters

txTypes?array<PrimaryNetworkTxType>

Query param for filtering items based on transaction types.

startTimestamp?integer

Query param for retrieving items after a specific timestamp.

Range0 <= value
endTimestamp?integer

Query param for retrieving items before a specific timestamp.

Range0 <= value
pageToken?string

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

pageSize?integer

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

Default10
Range1 <= value <= 100

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://data-api.avax.network/v1/networks/mainnet/blockchains/x-chain/assets/th5aLdWLi32yS9ED6uLGoMMubqHjzMsXhKWwzP6yZTYQKYzof/transactions?txTypes=AddValidatorTx&startTimestamp=1689541049&endTimestamp=1689800249&pageSize=10"
{
  "nextPageToken": "string",
  "transactions": [
    {
      "txHash": "3j9JpF1aGuQtLLbo3YkvvKkWrCZViXZjdeJQWUSEY5hcqUn2c",
      "chainFormat": "non-linear",
      "timestamp": 1600762738,
      "txType": "BaseTx",
      "memo": "0x546865204176616c616e6368652050726f6a656374",
      "consumedUtxos": [
        {
          "addresses": [
            "avax1qm2a25eytsrj235hxg6jc0mwk99tss64eqevsw"
          ],
          "asset": {
            "assetId": "th5aLdWLi32yS9ED6uLGoMMubqHjzMsXhKWwzP6yZTYQKYzof",
            "name": "Avalanche",
            "symbol": "AVAX",
            "denomination": 9,
            "type": "secp256k1",
            "amount": "5001000"
          },
          "consumedOnChainId": "2oYMBNV4eNHyqk2fjjV5nVQLDbtmNJzq5s3qs3Lo6ftnC6FByM",
          "consumingTxHash": "3j9JpF1aGuQtLLbo3YkvvKkWrCZViXZjdeJQWUSEY5hcqUn2c",
          "createdOnChainId": "2oYMBNV4eNHyqk2fjjV5nVQLDbtmNJzq5s3qs3Lo6ftnC6FByM",
          "utxoId": "68vLva9kfKUsX88ZPM8jdbf8qHUZRoZSFH6NdpAVTspkfrXDC",
          "utxoBytes": "string",
          "consumingTxTimestamp": 1599696000,
          "creationTxHash": "FvwEAhmxKfeiG8SnEvq42hc6whRyY3EFYAvebMqDNDGCgxN5Z",
          "credentials": [
            {
              "signature": "bWWoZUu0Z3STjuk/+2az7M4vP0oqc9NtiA7kOdqINCIE/2+5va5R1KNCWwEX5jE1xVHLvAxU2LHTN5gK8m84HwA",
              "publicKey": "AdMQOtubgBFFJu++0faHPIIA6KmdZ2ERErMRGzyy6juI"
            }
          ],
          "groupId": 0,
          "locktime": 0,
          "outputIndex": "38",
          "payload": "string",
          "threshold": 1,
          "timestamp": 1599696000,
          "utxoType": "mint"
        }
      ],
      "emittedUtxos": [
        {
          "addresses": [
            "avax1qm2a25eytsrj235hxg6jc0mwk99tss64eqevsw"
          ],
          "asset": {
            "assetId": "th5aLdWLi32yS9ED6uLGoMMubqHjzMsXhKWwzP6yZTYQKYzof",
            "name": "Avalanche",
            "symbol": "AVAX",
            "denomination": 9,
            "type": "secp256k1",
            "amount": "5001000"
          },
          "consumedOnChainId": "2oYMBNV4eNHyqk2fjjV5nVQLDbtmNJzq5s3qs3Lo6ftnC6FByM",
          "consumingTxHash": "3j9JpF1aGuQtLLbo3YkvvKkWrCZViXZjdeJQWUSEY5hcqUn2c",
          "createdOnChainId": "2oYMBNV4eNHyqk2fjjV5nVQLDbtmNJzq5s3qs3Lo6ftnC6FByM",
          "utxoId": "68vLva9kfKUsX88ZPM8jdbf8qHUZRoZSFH6NdpAVTspkfrXDC",
          "utxoBytes": "string",
          "consumingTxTimestamp": 1599696000,
          "creationTxHash": "FvwEAhmxKfeiG8SnEvq42hc6whRyY3EFYAvebMqDNDGCgxN5Z",
          "credentials": [
            {
              "signature": "bWWoZUu0Z3STjuk/+2az7M4vP0oqc9NtiA7kOdqINCIE/2+5va5R1KNCWwEX5jE1xVHLvAxU2LHTN5gK8m84HwA",
              "publicKey": "AdMQOtubgBFFJu++0faHPIIA6KmdZ2ERErMRGzyy6juI"
            }
          ],
          "groupId": 0,
          "locktime": 0,
          "outputIndex": "38",
          "payload": "string",
          "threshold": 1,
          "timestamp": 1599696000,
          "utxoType": "mint"
        }
      ],
      "amountUnlocked": [
        {
          "assetId": "th5aLdWLi32yS9ED6uLGoMMubqHjzMsXhKWwzP6yZTYQKYzof",
          "name": "Avalanche",
          "symbol": "AVAX",
          "denomination": 9,
          "type": "secp256k1",
          "amount": "5001000"
        }
      ],
      "amountCreated": [
        {
          "assetId": "th5aLdWLi32yS9ED6uLGoMMubqHjzMsXhKWwzP6yZTYQKYzof",
          "name": "Avalanche",
          "symbol": "AVAX",
          "denomination": 9,
          "type": "secp256k1",
          "amount": "5001000"
        }
      ],
      "sourceChain": "2oYMBNV4eNHyqk2fjjV5nVQLDbtmNJzq5s3qs3Lo6ftnC6FByM",
      "destinationChain": "2oYMBNV4eNHyqk2fjjV5nVQLDbtmNJzq5s3qs3Lo6ftnC6FByM",
      "assetCreated": {
        "assetId": "th5aLdWLi32yS9ED6uLGoMMubqHjzMsXhKWwzP6yZTYQKYzof",
        "name": "Avalanche",
        "symbol": "AVAX",
        "denomination": 9,
        "type": "secp256k1",
        "createdAtTimestamp": 1675444720,
        "cap": "fixed"
      },
      "vertices": [
        {
          "hash": "82qPRREHmh8Cfta4PGD6GymY9ZLyvgYugqW6hj9FykpMVRz1S",
          "height": 1961,
          "timestamp": 1600762738
        }
      ]
    }
  ],
  "chainInfo": {
    "chainName": "p-chain",
    "network": "mainnet"
  }
}
{
  "message": "string",
  "statusCode": 400,
  "error": "Bad Request"
}
{
  "message": "string",
  "statusCode": 401,
  "error": "Unauthorized"
}
{
  "message": "string",
  "statusCode": 403,
  "error": "Forbidden"
}
{
  "message": "string",
  "statusCode": 404,
  "error": "Not Found"
}
{
  "message": "string",
  "statusCode": 429,
  "error": "Too Many Requests"
}
{
  "message": "string",
  "statusCode": 500,
  "error": "Internal Server Error"
}
{
  "message": "string",
  "statusCode": 502,
  "error": "Bad Gateway"
}
{
  "message": "string",
  "statusCode": 503,
  "error": "Service Unavailable"
}

Is this guide helpful?