Skip to content

Monitoring

In the store, Develop → your project has tabs for Analytics, Health, Miners, Proofs, Revenue and Announcements. The same data is in the API.

Developer endpoints (session or API key with analytics:read)

Section titled “Developer endpoints (session or API key with analytics:read)”
Endpoint What
GET /v1/developers/projects/{id}/health status (healthy, degraded, underfunded, paused, fallback), eligible_miners, committee_size, fallback_rounds_24h, contested_rounds_24h, median_finality_ms, runway_epochs, issues
GET /v1/developers/projects/{id}/analytics?period=7d miners, rounds, units, earnings and growth; period = 24h, 7d (default), 30d or all
GET /v1/developers/projects/{id}/revenue?period=7d per-epoch gross / miner / developer / treasury totals
GET /v1/developers/projects/{id}/proofs recent rounds with their committee outcome
GET /v1/developers/projects/{id}/simulations simulation runs
Terminal window
curl -s https://testnet-rpc.necter.network/v1/developers/projects/$PROJECT_ID/health \
-H "Authorization: Bearer $NECTER_API_KEY"
Endpoint What
GET /v1/projects/{id} listing, status, economics, token, stats
GET /v1/projects/{id}/stats, /economics, /miners, /epochs, /rounds live numbers
GET /v1/explorer/rounds?project_id=…, /v1/explorer/rounds/{round_id} rounds with votes and finality
GET /v1/explorer/receipts/{receipt_hash} a receipt and where it was used
GET /v1/explorer/epochs/{project_id}/{epoch} the attested epoch receipt and its on-chain settlement
GET /v1/committees/{project_id}/{epoch} the attested miner-set snapshot
GET /v1/explorer/stats, GET /v1/status network-wide totals and health

Live example (the reference project):

Terminal window
curl -s "https://testnet-rpc.necter.network/v1/projects/0x84588f60bd2190a6c7929d655010de448e15d22d61ec8021b29ef2c56a553743/rounds?limit=1"
curl -s https://testnet-rpc.necter.network/v1/explorer/stats
{"collateral_bonded":"310000000000000000000","devices_online":4,"miners_online":3,"projects_listed":1,
"rounds_24h":104,"rounds_finalized_24h":103,"units_24h":301,"updated_at":1791474274,"validators":4}
Signal Action
runway_epochs low, status underfunded Fund the vault. Vault
fallback_rounds_24h high, eligible_miners < min_size Not enough miners: lower min_collateral or requirements, raise rewards, post an announcement
contested_rounds_24h rising Look for non-determinism in your worker (different results on different engines or inputs at the gas limit)
median_finality_ms high Shorter round_secs, more backups, or relax engines

Tell your miners about changes: POST /v1/developers/projects/{id}/announcements with {"title", "content", "type": "update" | "maintenance" | "feature" | "alert"}. They show on the project page.