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 |
curl -s https://testnet-rpc.necter.network/v1/developers/projects/$PROJECT_ID/health \ -H "Authorization: Bearer $NECTER_API_KEY"Public endpoints (no auth)
Section titled “Public endpoints (no auth)”| 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):
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}What to watch
Section titled “What to watch”| 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 |
Announcements
Section titled “Announcements”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.