Skip to content
Beam Docs
Realtime telemetry

Realtime: closed network summary: bandwidth, capacity, providers and weights.

GET
/v1/telemetry/realtime/network

Current evidence from live projections, including transfers in progress; work awaiting verification is reported separately from verified work. Epoch reads return complete sets of closed epochs only. Twice the matching snapshot price. Cursor filters and pinned snapshot/version must remain unchanged between pages. No private storage or participant timing claims are disclosed.

Authorization

consoleKey
X-Api-Key<token>

Organization Console API key. Explicit telemetry:read (realtime: telemetry:realtime:read), prepaid credits, organization/project grant; no environment-only grant.

In: header

Query Parameters

snapshotId?string

A live version from a realtime read; superseded versions stay readable for 10 minutes.

Formatuuid

Header Parameters

If-None-Match?string

ETag of a payload already held; a match answers 304 without a charge.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/telemetry/realtime/network"
{  "snapshotId": "09520abc-01e6-4da1-8fa5-f10e3883c861",  "version": "string",  "observedAt": "2019-08-24T14:15:22Z",  "sourceEpoch": 0,  "formulaReference": "http://example.com",  "publishedAt": "2019-08-24T14:15:22Z",  "evidenceSequence": "string",  "data": {    "workerCount": 0,    "orchestratorCount": 0,    "validatorCount": 0,    "completedTransfers": 0,    "transferredBytes": 0,    "lookbackDays": 0,    "observationHour": "2019-08-24T14:15:22Z",    "measurementWindowStart": "2019-08-24T14:15:22Z",    "measurementWindowEnd": "2019-08-24T14:15:22Z",    "reportedCapacityMbps": 0,    "workloads": [      {        "measurementWindowStart": "2019-08-24T14:15:22Z",        "measurementWindowEnd": "2019-08-24T14:15:22Z",        "reportedCapacityMbps": 0,        "verifiedBandwidthMbps": 0,        "metricDescription": "duration_weighted_mean_assignment_goodput",        "measuredBytes": 0,        "measuredDurationMs": 0,        "originalTaskCount": 0,        "attemptCount": 0,        "recoveryAttemptCount": 0,        "successfulTasks": 0,        "failedTasks": 0,        "neutralExcludedTasks": 0,        "pendingVerificationTasks": 0,        "workload": "standard_transfers",        "orchestratorCount": 0,        "verifiedBytes": 0,        "recoveryVerifiedBytes": 0      }    ],    "providers": [      {        "provider": "string",        "workerCount": 0      }    ],    "weights": {}  }}

Decentralized distributed bandwidth infrastructure.