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

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

async function run() {
  const result = await avaCloudSDK.data.primaryNetwork.vertices.listByHeight({
    vertexHeight: 123,
    pageSize: 10,
    blockchainId: "x-chain",
    sortOrder: "asc",
  });

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

run();
{
  "nextPageToken": "<string>",
  "vertices": [
    {
      "vertexHash": "<string>",
      "parentHashes": [
        "<string>"
      ],
      "vertexHeight": 123,
      "vertexIndex": 123,
      "vertexTimestamp": 123,
      "txCount": 123,
      "transactions": [
        "<string>"
      ],
      "vertexSizeBytes": 123
    }
  ],
  "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:
2oYMBNV4eNHyqk2fjjV5nVQLDbtmNJzq5s3qs3Lo6ftnC6FByM,
2JVSBoinj9C2J33VntvzYtVJNZdN2NKiwwKjcumHUWEb5DbBrm,
2piQ2AVHCjnduiWXsSY15DtbVuwHE2cwMHYnEXHsLL73BBkdbV,
x-chain
​
network
enum<string>
required

Either mainnet or testnet/fuji.

Available options:
mainnet,
fuji,
testnet

Query Parameters

​
vertexHeight
integer
required

The height of a vertex.

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

The response is of type object.