v1

latestOpenAPI 3.1.02026-07-1288262495.0 KB
Data API Usage Metrics

Get usage metrics for the Primary Network RPC

Gets metrics for public Primary Network RPC usage over a specified time interval aggregated at the specified time-duration granularity.

get/v1/primaryNetworkRpcUsageMetrics

Query parameters

timeInterval'hourly' | 'daily' | 'weekly' | 'monthly'

Time interval granularity for data aggregation for subnet rpc metrics

startTimestampinteger

The start time of the range as a UNIX timestamp. The requested start time will be rounded down to 0:00 UTC of the day.

endTimestampinteger

The end time of the range as a UNIX timestamp. The requested end time will be rounded down to 0:00 UTC of the day.

groupBy'rpcMethod' | 'requestPath' | 'responseCode' | 'country' | 'continent' | 'userAgent'

Query param for the criterion used for grouping metrics

responseCodestring

Filter data by response status code.

requestPathstring

Filter data by request path.

countrystring

Filter data by Country. Input must be a valid ISO 3166-1 alpha-2 country code. "XX" - Represents clients without country code data. "T1" - Represents clients using the Tor network.

continentstring

Filter data by Continent. Input must be a valid ISO 3166-1 alpha-2 continent code.

userAgentstring

Filter data by User Agent.

rpcMethodstring

Filter data by RPC method.

network'mainnet' | 'fuji' | 'testnet' required

Either mainnet or testnet/fuji.

Response

Successful response

aggregateDurationstring required

Duration in which the metrics value is aggregated

network'mainnet' | 'testnet' required

Network type for which the metrics are aggregated

Example response

{
  "network": "mainnet"
}