GET
/
v2
/
chains
/
{chainId}
/
metrics
/
{metric}
import { AvaCloudSDK } from "@avalabs/avacloud-sdk";

const avaCloudSDK = new AvaCloudSDK({
  chainId: "43114",
  network: "mainnet",
});

async function run() {
  const result = await avaCloudSDK.metrics.chain.metrics.getEvmChainMetrics({
    metric: "activeAddresses",
    startTimestamp: 1689541049,
    endTimestamp: 1689800249,
    timeInterval: "day",
    chainId: "43114",
  });

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

run();
{
  "nextPageToken": "<string>",
  "results": [
    {
      "value": 123,
      "timestamp": 123
    }
  ]
}

Path Parameters

​
metric
enum<string>
required

Which chain level metric to fetch.

Available options:
activeAddresses,
activeSenders,
cumulativeTxCount,
cumulativeAddresses,
cumulativeContracts,
cumulativeDeployers,
gasUsed,
txCount,
avgGps,
maxGps,
avgTps,
maxTps,
avgGasPrice,
maxGasPrice,
feesPaid
​
chainId
string
required

A supported EVM chain ID or one of "total", "mainnet", or "testnet". Use the /chains endpoint to get a list of supported chain IDs.

Query Parameters

​
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
​
timeInterval
enum<string>

Time interval granularity for data aggregation. Metrics prefixed with "cumulative", "max", or "avg" only support timeInterval equal to "day".

Available options:
hour,
day,
week,
month
​
pageToken
string

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

​
pageSize
integer
default:
100

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

Required range: 1 < x < 2160

Response

200
application/json
Successful response
​
results
object[]
required

Array of current metrics values at different timestamps.

​
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?

Get chain information for supported blockchainGet rolling window metrics for EVM chains