> ## 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 metrics for EVM chains > EVM chain metrics are available for all Avalanche L1s on _Mainnet_ and _Fuji_ (testnet). You can request metrics by EVM chain ID. See the `/chains` endpoint for all supported chains. All metrics are updated several times every hour. Each metric data point has a `value` and `timestamp` (Unix timestamp in seconds). All metric values include data within the duration of the associated timestamp plus the requested `timeInterval`. All timestamps are fixed to the hour. When requesting a timeInterval of **day**, **week**, or **month**, the timestamp will be 0:00 UTC of the day, Monday of the week, or first day of the month, respectively. The latest data point in any response may change on each update. ### Metrics activeAddresses: The number of distinct addresses seen within the selected `timeInterval` starting at the timestamp. Addresses counted are those that appear in the “from” and “to” fields of a transaction or ERC20/ERC721/ERC1155 transfer log event. activeSenders: This metric follows the same structure as activeAddresses, but instead only counts addresses that appear in the “from” field of the respective transaction or transfer log event. cumulativeTxCount: The cumulative transaction count from genesis up until 24 hours after the timestamp. This aggregation can be considered a “rolling sum” of the transaction count metric (txCount). Only `timeInterval=day` supported. cumulativeAddresses: The cumulative count of unique addresses from genesis up until 24 hours after the timestamp. Addresses counted are those that appear in the “from” and “to” fields of a transaction or ERC20/ERC721/ERC1155 transfer log event. Only `timeInterval=day` supported. cumulativeContracts: The cumulative count of contracts created from genesis up until the timestamp. Contracts are counted by looking for the CREATE, CREATE2, and CREATE3 call types in all transaction traces (aka internal transactions). Only `timeInterval=day` supported. cumulativeDeployers: The cumulative count of unique contract deployers from genesis up until 24 hours after the timestamp. Deployers counted are those that appear in the “from” field of transaction traces with the CREATE, CREATE2, and CREATE3 call types. Only `timeInterval=day` supported. contracts: The count of contracts created within the requested timeInterval starting at the timestamp. Contracts are counted by looking for the CREATE, CREATE2, and CREATE3 call types in all transaction traces (aka internal transactions). Only `timeInterval=day` supported. deployers: The count of unique deployers within the requested timeInterval starting at the timestamp. Deployers counted are those that appear in the “from” field of transaction traces with the CREATE, CREATE2, and CREATE3 call types. Only `timeInterval=day` supported. gasUsed: The amount of gas used by transactions within the requested timeInterval starting at the timestamp. txCount: The amount of transactions within the requested timeInterval starting at the timestamp. avgGps: The average Gas used Per Second (GPS) within the day beginning at the timestamp. The average is calculated by taking the sum of gas used by all blocks within the day and dividing it by the time interval between the last block of the previous day and the last block of the day that begins at the timestamp. Only `timeInterval=day` supported. maxGps: The max Gas used Per Second (GPS) measured within the day beginning at the timestamp. Each GPS data point is calculated using the gas used in a single block divided by the time since the last block. Only `timeInterval=day` supported. avgTps: The average Transactions Per Second (TPS) within the day beginning at the timestamp. The average is calculated by taking the sum of transactions within the day and dividing it by the time interval between the last block of the previous day and the last block of the day that begins at the timestamp. Only `timeInterval=day` supported. maxTps: The max Transactions Per Second (TPS) measured within the day beginning at the timestamp. Each TPS data point is calculated by taking the number of transactions in a single block and dividing it by the time since the last block. Only `timeInterval=day` supported. avgGasPrice: The average gas price within the day beginning at the timestamp. The gas price used is the price reported in transaction receipts. Only `timeInterval=day` supported. maxGasPrice: The max gas price seen within the day beginning at the timestamp. The gas price used is the price reported in transaction receipts. Only `timeInterval=day` supported. feesPaid: The sum of transaction fees paid within the day beginning at the timestamp. The fee is calculated as the gas used multiplied by the gas price as reported in all transaction receipts. Only `timeInterval=day` supported. ## OpenAPI ````yaml get /v2/chains/{chainId}/metrics/{metric} openapi: 3.1.0 info: title: Metrics API description: >- The Metrics API provides metrics and analytics of on-chain activity. 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://metrics.avax.network security: [] tags: - name: EVM Chains description: Find information about which routes are supported for a given EVM chainID. - name: Chain Metrics description: Get network level staking and usage metrics. - name: L1 Validator Metrics description: Get network level l1 validator metrics. - name: Looking Glass description: >- Looking Glass is a tool that allows users to look up information for future airdrops. - name: Health Check - name: Chain Throughput description: Get throughput metrics for a given chain. - name: Cumulative description: Get cumulative metrics for a given chain. - name: Staking Information description: Get staking information for a given chain. paths: /v2/chains/{chainId}/metrics/{metric}: get: tags: - Chain Metrics summary: Get metrics for EVM chains description: >- EVM chain metrics are available for all Avalanche L1s on _Mainnet_ and _Fuji_ (testnet). You can request metrics by EVM chain ID. See the `/chains` endpoint for all supported chains. All metrics are updated several times every hour. Each metric data point has a `value` and `timestamp` (Unix timestamp in seconds). All metric values include data within the duration of the associated timestamp plus the requested `timeInterval`. All timestamps are fixed to the hour. When requesting a timeInterval of **day**, **week**, or **month**, the timestamp will be 0:00 UTC of the day, Monday of the week, or first day of the month, respectively. The latest data point in any response may change on each update. ### Metrics activeAddresses: The number of distinct addresses seen within the selected `timeInterval` starting at the timestamp. Addresses counted are those that appear in the “from” and “to” fields of a transaction or ERC20/ERC721/ERC1155 transfer log event. activeSenders: This metric follows the same structure as activeAddresses, but instead only counts addresses that appear in the “from” field of the respective transaction or transfer log event. cumulativeTxCount: The cumulative transaction count from genesis up until 24 hours after the timestamp. This aggregation can be considered a “rolling sum” of the transaction count metric (txCount). Only `timeInterval=day` supported. cumulativeAddresses: The cumulative count of unique addresses from genesis up until 24 hours after the timestamp. Addresses counted are those that appear in the “from” and “to” fields of a transaction or ERC20/ERC721/ERC1155 transfer log event. Only `timeInterval=day` supported. cumulativeContracts: The cumulative count of contracts created from genesis up until the timestamp. Contracts are counted by looking for the CREATE, CREATE2, and CREATE3 call types in all transaction traces (aka internal transactions). Only `timeInterval=day` supported. cumulativeDeployers: The cumulative count of unique contract deployers from genesis up until 24 hours after the timestamp. Deployers counted are those that appear in the “from” field of transaction traces with the CREATE, CREATE2, and CREATE3 call types. Only `timeInterval=day` supported. contracts: The count of contracts created within the requested timeInterval starting at the timestamp. Contracts are counted by looking for the CREATE, CREATE2, and CREATE3 call types in all transaction traces (aka internal transactions). Only `timeInterval=day` supported. deployers: The count of unique deployers within the requested timeInterval starting at the timestamp. Deployers counted are those that appear in the “from” field of transaction traces with the CREATE, CREATE2, and CREATE3 call types. Only `timeInterval=day` supported. gasUsed: The amount of gas used by transactions within the requested timeInterval starting at the timestamp. txCount: The amount of transactions within the requested timeInterval starting at the timestamp. avgGps: The average Gas used Per Second (GPS) within the day beginning at the timestamp. The average is calculated by taking the sum of gas used by all blocks within the day and dividing it by the time interval between the last block of the previous day and the last block of the day that begins at the timestamp. Only `timeInterval=day` supported. maxGps: The max Gas used Per Second (GPS) measured within the day beginning at the timestamp. Each GPS data point is calculated using the gas used in a single block divided by the time since the last block. Only `timeInterval=day` supported. avgTps: The average Transactions Per Second (TPS) within the day beginning at the timestamp. The average is calculated by taking the sum of transactions within the day and dividing it by the time interval between the last block of the previous day and the last block of the day that begins at the timestamp. Only `timeInterval=day` supported. maxTps: The max Transactions Per Second (TPS) measured within the day beginning at the timestamp. Each TPS data point is calculated by taking the number of transactions in a single block and dividing it by the time since the last block. Only `timeInterval=day` supported. avgGasPrice: The average gas price within the day beginning at the timestamp. The gas price used is the price reported in transaction receipts. Only `timeInterval=day` supported. maxGasPrice: The max gas price seen within the day beginning at the timestamp. The gas price used is the price reported in transaction receipts. Only `timeInterval=day` supported. feesPaid: The sum of transaction fees paid within the day beginning at the timestamp. The fee is calculated as the gas used multiplied by the gas price as reported in all transaction receipts. Only `timeInterval=day` supported. operationId: getEvmChainMetrics parameters: - name: metric required: true in: path description: Which chain level metric to fetch. example: activeAddresses schema: $ref: '#/components/schemas/ChainMetric' - name: startTimestamp required: false in: query description: Query param for retrieving items after a specific timestamp. example: 1689541049 schema: minimum: 0 type: integer - name: endTimestamp required: false in: query description: Query param for retrieving items before a specific timestamp. example: 1689800249 schema: minimum: 0 type: integer - name: timeInterval required: false in: query description: |- Time interval granularity for data aggregation. Metrics prefixed with "cumulative", "max", or "avg" only support timeInterval equal to "day". example: day schema: $ref: '#/components/schemas/TimeIntervalGranularity' - name: pageToken required: false in: query description: >- A page token, received from a previous list call. Provide this to retrieve the subsequent page. schema: type: string - name: pageSize required: false in: query description: >- The maximum number of items to return. The minimum page size is 1. The maximum pageSize is 2160. schema: type: integer default: 100 minimum: 1 maximum: 2160 example: '10' - name: chainId required: true in: path description: >- A supported EVM chain ID or one of "total", "mainnet", or "testnet". Use the `/chains` endpoint to get a list of supported chain IDs. example: '43114' schema: type: string responses: '200': description: Successful response content: application/json: schema: $ref: '#/components/schemas/MetricsApiResponse' '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({ chainId: "43114", }); async function run() { const result = await avalanche.metrics.chains.getMetrics({ metric: "activeAddresses", startTimestamp: 1689541049, endTimestamp: 1689800249, timeInterval: "day", pageSize: 10, }); for await (const page of result) { console.log(page); } } run(); components: schemas: ChainMetric: type: string enum: - activeAddresses - activeSenders - cumulativeTxCount - cumulativeAddresses - cumulativeContracts - cumulativeDeployers - contracts - deployers - gasUsed - txCount - avgGps - maxGps - avgTps - maxTps - avgGasPrice - maxGasPrice - feesPaid TimeIntervalGranularity: type: string enum: - hour - day - week - month MetricsApiResponse: type: object properties: nextPageToken: type: string description: >- 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. results: description: Array of current metrics values at different timestamps. type: array items: $ref: '#/components/schemas/MetricsValue' required: - results 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 MetricsValue: type: object properties: value: type: number description: Aggregated value for the current metrics. timestamp: type: number description: >- Unix Epoch timestamp for which metrics are aggregated. Depending on the interval of the metric this can be at the start of the relevant hour, day, month, year, etc. required: - value - timestamp ````