Skip to content
Beam Docs
Realtime telemetry

Realtime: closed network snapshot versions.

GET
/v1/telemetry/realtime/network/history

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

limit?integer
Range1 <= value <= 100
Default100
cursor?string
Lengthlength <= 1024
snapshotId?string

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

Formatuuid
since?string
Formatdate-time
until?string
Formatdate-time

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/history"
{  "nextCursor": "string",  "items": [    {      "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.