API referenceRPC
RPC Usage
Last updated
Fetch RPC reverse-proxy usage analytics — request volume, latency p50/p95, failover + error rate, cache-hit rate, per-endpoint distribution, and bounded time buckets for heatmaps — over a 7d or 30d window (computed live from the store telemetry).
Query Parameters
window?string
Trailing lookback window the response is computed over, ending at the most recent data point rather than at today. Accepts 7d, 30d. A longer window is not a superset of a shorter one -- rankings and rates are recomputed over the whole window, not summed.
Default
"7d"Value in
- "7d"
- "30d"
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/v1/rpc/usage"{ "data": { "bucket_granularity": "example", "buckets": [ { "avg_latency_ms": 120, "errors": 1, "requests": 1, "ts": 1 } ], "coverage": { "end": 1, "latency_percentiles": { "end": 1, "start": 1 }, "segments": [ { "end": 1, "source": "live-cron-prober", "start": 1 } ], "start": 1 }, "endpoints": [ { "endpoint_id": "https://api.metagraph.sh/example", "ok_requests": 1, "requests": 1 } ], "networks": [ { "network": "example", "ok_requests": 1, "requests": 1 } ], "observed_at": 1, "schema_version": 1, "source": "live-cron-prober", "summary": { "cache_hit_rate": 0.5, "cache_hits": 1, "error_rate": 0.5, "error_requests": 1, "failover_rate": 0.5, "failover_requests": 1, "latency_ms": {}, "ok_requests": 1, "total_requests": 1 }, "window": "30d" }, "meta": { "artifact_path": "example", "cache": "short", "contract_version": "2026-06-29.1", "generated_at": "2026-06-01T00:00:00.000Z", "observed_through": "2026-06-01T00:00:00.000Z", "pagination": { "collection": "example", "cursor": 1, "limit": 1, "next_cursor": 1, "order": "asc", "returned": 1, "sort": "example", "total": 1 }, "published_at": "2026-06-01T00:00:00.000Z", "source": "live-cron-prober", "stale_contract": { "built_under": "example", "live": "example" } }, "ok": true, "schema_version": 1}