Granite Upgrade Activates in11d:16h:54m:33s
Chain Metrics

Get ICM summary metrics

Get rolling window ICM message counts (last hour, day, month, 90 days, year, all time).

Use filters (srcBlockchainId, destBlockchainId, network) to select data, and the groupBy parameter for aggregation level.

Examples:

  • Specific pair: ?srcBlockchainId=...&destBlockchainId=...

  • From one source (aggregated): ?srcBlockchainId=...

  • From one source (by destination): ?srcBlockchainId=...&groupBy=destBlockchainId

  • To one destination (aggregated): ?destBlockchainId=...

  • To one destination (by source): ?destBlockchainId=...&groupBy=srcBlockchainId

  • Network total: ?network=mainnet

  • Network breakdown: ?network=mainnet&groupBy=srcBlockchainId,destBlockchainId.

GET
/v2/icm/summary

Query Parameters

srcBlockchainId?string

Query param for retrieving items for a specific source (initiating) blockchain id.

destBlockchainId?string

Query param for retrieving items for a specific destination (receiving) blockchain id.

groupBy?string

Group results by srcBlockchainId, destBlockchainId, or both (comma-separated)

Value in"srcBlockchainId" | "destBlockchainId" | "srcBlockchainId,destBlockchainId"
network?string

Either mainnet or testnet/fuji.

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

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://metrics.avax.network/v2/icm/summary?groupBy=destBlockchainId&network=mainnet"
{
  "result": {
    "lastHour": 0,
    "lastDay": 0,
    "lastWeek": 0,
    "lastMonth": 0,
    "last90Days": 0,
    "lastYear": 0,
    "allTime": 0,
    "srcBlockchainId": "string",
    "destBlockchainId": "string"
  }
}
{
  "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?