{"openapi":"3.1.0","info":{"title":"Epic Cash status API","summary":"Live health, uptime and consensus state for Epic Cash public nodes, Epicbox relays and mining pools, on mainnet and floonet.","description":"\nEverything on the board is available here. Read routes send\n`access-control-allow-origin: *`, so a browser can consume them directly without a\nproxy.\n\n**Nothing is probed when you call this.** One poller writes state on a fixed cadence\nand every caller reads the same cached snapshot. Calling this API does not generate\ntraffic to any monitored server, which is why it is open.\n\n### Cadence\n\nNodes are checked every 30 seconds with a single unauthenticated `get_tip`. Epicbox\nrelays every 30 seconds, by opening a WebSocket and reading the one `Challenge` frame\nthe relay sends unprompted. Mining pools every 30 seconds, with one GET against the\npool's own stats endpoint. Node versions every 5 minutes, certificate expiry every 6\nhours.\n\n### What is not here\n\nPeer counts and sync status. Those live on a node's owner API and need an\n`api_secret`, so no third party can publish them — for anyone's node, not just ours.\nAnything claiming otherwise is guessing.\n\n### Reading the numbers\n\n`latency_ms` is the round trip from one prober, named in the `prober` object. It\ndescribes that host's path to the target as much as the target itself.\n\n`state` has three values, not two. `degraded` is the honest bucket for a node that is\nup but not fully usable — a private API, a lagging tip — and for a failure this prober\nhas not yet confirmed.\n\n`tip_lag` is the number worth alerting on. A node can answer every request while\nthousands of blocks behind.\n\n### Pools are not nodes\n\nA pool row carries `miners`, `workers`, `fee_percent` and `last_block_height`, and no\nheight or `tip_lag`. `last_block_height` is the last block that pool **found** — the\npools' own `currentHeight` field is the same number despite its name, and none of them\npublishes its node's chain tip.\n\nDo not compare it with `network.tip_height`. A pool finds blocks in proportion to its\nshare of the network, so the gap is large for a small pool and near zero for a large\none, and it measures pool size rather than pool health. For the same reason no\nthreshold is applied to the age of the last block: `green` on a pool row means its API\nanswered with valid stats.\n\nEvery pool's API is a different shape, so pools are integrated by hand. Submitting one\nrecords a request rather than starting an automatic check.\n\n### Server icons\n\nA server may have an `icon`: an object with `url` (the largest PNG), `urls` (every size,\nkeyed by pixel width), `hash` and `updated_at`, or `null` when it has none — show the\nhost's initials then. Files are square PNGs named by their content hash, served from\n`/api/v1/icons/` with a one-year immutable cache: a changed icon has a new URL. Over the\nonion service the URLs are on the onion address.\n","contact":{"name":"Source","url":"https://github.com/BTLabsUK/epic-status"},"license":{"name":"MIT","identifier":"MIT"},"version":"0.1.0"},"paths":{"/api/v1/status.json":{"get":{"tags":["status"],"summary":"The whole board","description":"Everything the page shows, in one document. Carries an `ETag`; send it back as `If-None-Match` and a repeat request costs nothing when nothing has changed.\n\nField names follow grin.fail's schema where they overlap, since that is already the de-facto shape in this ecosystem.","operationId":"statusjson_response_api_v1_status_json_get","parameters":[{"name":"chain","in":"query","required":false,"schema":{"type":"string","default":"mainnet","title":"Chain"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StatusResponse"}}}},"304":{"description":"Unchanged since the ETag you sent."},"503":{"description":"No sweep has completed yet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/nodes.json":{"get":{"tags":["lists"],"summary":"Node endpoints, as a plain list","description":"A bare list of endpoints, which is what a wallet or an exchange failover\nconfig actually wants. `?healthy=true` filters to the ones worth using.\n\nOne chain per response, mainnet by default. A wallet asking for node endpoints\nmust never be handed a floonet address mixed in with mainnet ones — it would\nconnect, sync a different chain, and look broken for reasons nothing on this\npage explains.","operationId":"nodesjson_response_api_v1_nodes_json_get","parameters":[{"name":"healthy","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Healthy"}},{"name":"chain","in":"query","required":false,"schema":{"type":"string","default":"mainnet","title":"Chain"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndpointList"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Service Unavailable"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/epicbox.json":{"get":{"tags":["lists"],"summary":"Epicbox hosts, as a plain list","operationId":"epicboxjson_response_api_v1_epicbox_json_get","parameters":[{"name":"healthy","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Healthy"}},{"name":"chain","in":"query","required":false,"schema":{"type":"string","default":"mainnet","title":"Chain"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EpicboxList"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Service Unavailable"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/pools.json":{"get":{"tags":["lists"],"summary":"Mining pools, as a plain list","description":"Pool hosts, for a miner-facing switcher or a wallet's pool picker. `?healthy=true` filters to the ones answering right now.","operationId":"poolsjson_response_api_v1_pools_json_get","parameters":[{"name":"healthy","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Healthy"}},{"name":"chain","in":"query","required":false,"schema":{"type":"string","default":"mainnet","title":"Chain"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PoolList"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Service Unavailable"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/events.json":{"get":{"tags":["status"],"summary":"The incident log","description":"Outages, reorgs, forks, chain stalls and certificates close to expiry, newest first. A condition is one entry from start to end — `ended_at` is null while it is ongoing — and a reorg is an instant with its `depth`.\n\nRepeats of the same kind for the same host or chain within 24 hours of an entry's first occurrence are folded into it: `occurrences` counts them, `last_started_at` is the latest, `active_s` sums the closed ones and `occurrence_times` lists up to 50, newest first.\n\n`?min=warn` drops routine one-block reorgs and certificate notices; `?min=bad` leaves forks and stalls only. Also available as Atom at `/feed.atom`, which defaults to `warn`.","operationId":"events_json_api_v1_events_json_get","parameters":[{"name":"chain","in":"query","required":false,"schema":{"type":"string","default":"mainnet","title":"Chain"}},{"name":"min","in":"query","required":false,"schema":{"type":"string","default":"info","title":"Min"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventList"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/health":{"get":{"tags":["service"],"summary":"Is this monitor working","description":"Point your alerting here. 503 means **this observer** is broken or its data is stale — it says nothing about the Epic Cash network, and conflating the two is the most damaging mistake a status page can make.","operationId":"health_api_v1_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}},"503":{"description":"Stale or no data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}}}}},"/api/v1/icons/{name}":{"head":{"tags":["status"],"summary":"A server icon","description":"A square PNG, `<hash>-<size>.png`, as linked from a target's `icon` in status.json. Only approved icons are served; anything else is a 404. The name is the content hash, so the response is cacheable forever.","operationId":"server_icon_api_v1_icons__name__head","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string","title":"Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}},"image/png":{}}},"404":{"description":"No such icon."},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["status"],"summary":"A server icon","description":"A square PNG, `<hash>-<size>.png`, as linked from a target's `icon` in status.json. Only approved icons are served; anything else is a 404. The name is the content hash, so the response is cacheable forever.","operationId":"server_icon_api_v1_icons__name__head","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string","title":"Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}},"image/png":{}}},"404":{"description":"No such icon."},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/submit":{"post":{"tags":["submit"],"summary":"Add a node or relay","description":"Accepts a form body. The target is validated and queued; it is probed out of band and appears on the board once it answers three times, 60 seconds apart.\n\nSend `multipart/form-data` to include an optional `icon` file: PNG, JPEG or WebP, up to 1 MB and 2048×2048, still images only (SVG is refused). It is re-encoded to square PNGs and published only after an operator approves it.\n\n`kind` is `node`, `epicbox`, `epicmail` or `pool`. `epicmail` is an Epicbox relay running Epicmail and is handled as `epicbox`: Epicmail is detected from the relay's own `/.well-known/epicbox.json`, so either kind gets the badge.\n\nHosts resolving to private, loopback, link-local or reserved addresses are refused before anything is stored or contacted. Epicbox hostnames may contain only letters, digits and dots — a hyphen means the relay handshakes fine but no wallet can parse an address on it.","operationId":"submit_api_api_v1_submit_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_submit_api_api_v1_submit_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"202":{"description":"Queued for checking.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmitAccepted"}}}},"400":{"description":"Refused, with the reason.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmitRejected"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"Body_submit_api_api_v1_submit_post":{"properties":{"kind":{"type":"string","title":"Kind","default":"node"},"host":{"type":"string","title":"Host","default":""},"operator":{"type":"string","title":"Operator","default":""},"country":{"type":"string","title":"Country","default":""},"icon":{"anyOf":[{"type":"string","contentMediaType":"application/octet-stream"},{"type":"null"}],"title":"Icon"}},"type":"object","title":"Body_submit_api_api_v1_submit_post"},"EndpointList":{"properties":{"meta":{"$ref":"#/components/schemas/ListMeta"},"generated_at":{"type":"string","title":"Generated At"},"chain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Chain"},"tip_height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Tip Height"},"nodes":{"items":{"type":"string"},"type":"array","title":"Nodes","description":"Endpoint URLs, ready to paste into a wallet or a failover config.","examples":[["https://node.epiccash.com:3413","https://node.btlabs.uk"]]}},"type":"object","required":["meta","generated_at"],"title":"EndpointList"},"EpicboxList":{"properties":{"meta":{"$ref":"#/components/schemas/ListMeta"},"generated_at":{"type":"string","title":"Generated At"},"epicbox":{"items":{"type":"string"},"type":"array","title":"Epicbox","examples":[["epicbox.epiccash.com","epicbox.epicnet.us"]]},"epicmail":{"items":{"type":"string"},"type":"array","title":"Epicmail","description":"The hosts in `epicbox` that run Epicmail, in the same order.","examples":[["epicbox.btlabs.uk"]]}},"type":"object","required":["meta","generated_at"],"title":"EpicboxList"},"EpicboxStatus":{"properties":{"id":{"type":"string","title":"Id","description":"Stable identifier.","examples":["node.epiccash.com"]},"kind":{"type":"string","title":"Kind","description":"`node`, `epicbox` or `pool`.","examples":["node"]},"host":{"type":"string","title":"Host","examples":["node.epiccash.com:3413"]},"endpoint":{"type":"string","title":"Endpoint","description":"What is actually contacted.","examples":["https://node.epiccash.com:3413"]},"operator":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Operator","examples":["Epic Cash"]},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Label","examples":["Default node"]},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"verified":{"type":"boolean","title":"Verified","description":"Vouched for by this instance's operator as an official server. False means community-run, which is an absence of vouching rather than a judgement.","default":false},"listing":{"type":"string","title":"Listing","description":"`official` or `community` — the same fact as `verified`, as the value the board groups by.","default":"community","examples":["official"]},"source":{"type":"string","title":"Source","description":"`seed` or `submitted`.","examples":["seed"]},"state":{"type":"string","title":"State","description":"`healthy`, `degraded`, `down`, or `unknown`. Three states rather than two: a node whose API needs credentials is up but unpollable, a node far behind the tip answers perfectly, and a probe that failed from this host is not proof about that one.","examples":["healthy"]},"reason":{"type":"string","title":"Reason","description":"Machine-readable cause when not healthy, e.g. `tip_lag`, `api_restricted`, `timeout`, `p2p_only`. A relay with a certificate near expiry is not one of these: it stays `healthy` with `ok`, and the day count is published on its own in `cert_expires_in_days`.","examples":["ok"]},"detail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Detail","description":"The same cause in a sentence, as shown on the board."},"latency_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Latency Ms","description":"Round trip from this prober only. A latency figure is a statement about the measuring host's network as much as the target's.","examples":[118]},"last_checked_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Checked At","examples":["2026-09-22T06:42:35Z"]},"last_ok_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Ok At","description":"Last successful check. Only ever moves forward, and only on success. Null means it has never answered.","examples":["2026-09-22T06:42:35Z"]},"last_error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Error","description":"Verbatim failure text, published so an operator can diagnose their own endpoint without contacting anyone.","examples":["connection timed out"]},"error_count":{"type":"integer","title":"Error Count","description":"Consecutive failures.","default":0,"examples":[0]},"uptime":{"$ref":"#/components/schemas/Uptime"},"location":{"$ref":"#/components/schemas/Location"},"icon":{"anyOf":[{"$ref":"#/components/schemas/IconOut"},{"type":"null"}],"description":"The server's icon, or null when it has none — show the host's initials then. Only icons an operator has approved appear here."},"protocol_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Protocol Version","examples":["3.0.1"]},"cert_expires_in_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Cert Expires In Days","examples":[61]},"ipv6":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ipv6","description":"As for nodes: `yes`, `unreachable` or `absent`."},"software":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Software","description":"What the relay calls itself in `/.well-known/epicbox.json`. Null for the classic relay, which publishes no such document.","examples":["epicmail"]},"epicmail":{"anyOf":[{"$ref":"#/components/schemas/EpicmailDetail"},{"type":"null"}],"description":"Present when the relay is Epicmail; null otherwise."}},"type":"object","required":["id","kind","host","endpoint","source","state","reason","uptime","location"],"title":"EpicboxStatus"},"EpicmailDetail":{"properties":{"version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Version","examples":["0.1.1"]},"protocol_versions":{"items":{"type":"string"},"type":"array","title":"Protocol Versions","examples":[["2.0.0","3.0.0","3.1.0"]]},"cancel":{"type":"boolean","title":"Cancel","description":"Speaks 3.1.0, which adds transaction cancel.","default":false},"mux":{"type":"boolean","title":"Mux","description":"Offers `mux/1`: many mailboxes on one socket.","default":false},"https_api":{"anyOf":[{"$ref":"#/components/schemas/EpicmailHttpsApi"},{"type":"null"}],"description":"The HTTPS pull API, when the relay offers it."},"federation":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Federation"},"info_checked_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Info Checked At"},"health":{"anyOf":[{"$ref":"#/components/schemas/EpicmailHealth"},{"type":"null"}]}},"type":"object","title":"EpicmailDetail","description":"From the relay's `/.well-known/epicbox.json` (read every six hours) and its\nreadiness."},"EpicmailHealth":{"properties":{"ok":{"type":"boolean","title":"Ok","description":"The relay answered with a usable document."},"source":{"type":"string","title":"Source","description":"`status.json` or `ready`.","examples":["status.json"]},"ready":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Ready","description":"Not restarting and the message store's last write check passed."},"draining":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Draining"},"store_ok":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Store Ok"},"version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Version","examples":["0.1.1"]},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"checked_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Checked At"}},"type":"object","required":["ok","source"],"title":"EpicmailHealth","description":"Readiness from the relay's own `/status.json` (or `/ready` when that is missing),\nread every two minutes. No traffic counts."},"EpicmailHttpsApi":{"properties":{"protocol":{"type":"string","title":"Protocol","examples":["epicbox-https/0.1"]},"ok":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Ok","description":"Whether `/v1/info` answered with this protocol. Null if not checked."}},"type":"object","required":["protocol"],"title":"EpicmailHttpsApi"},"ErrorResponse":{"properties":{"error":{"type":"string","title":"Error","examples":["no data yet"]},"generated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Generated At"}},"type":"object","required":["error"],"title":"ErrorResponse"},"EventList":{"properties":{"generated_at":{"type":"string","title":"Generated At"},"chain":{"type":"string","title":"Chain"},"min_severity":{"type":"string","title":"Min Severity"},"events":{"items":{"$ref":"#/components/schemas/EventOut"},"type":"array","title":"Events"}},"type":"object","required":["generated_at","chain","min_severity","events"],"title":"EventList"},"EventOut":{"properties":{"id":{"type":"integer","title":"Id","examples":[412]},"kind":{"type":"string","title":"Kind","description":"`down`, `reorg`, `fork`, `stall` or `cert_expiring`.","examples":["down"]},"severity":{"type":"string","title":"Severity","description":"`info`, `warn` or `bad`.","examples":["warn"]},"subject":{"type":"string","title":"Subject","description":"A host, or the chain itself.","examples":["node.epicnet.us:3413"]},"target":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target","description":"The target's `id`, while it is still monitored."},"detail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Detail","examples":["connection timed out"]},"depth":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Depth","description":"Blocks replaced, for a reorg."},"started_at":{"type":"string","title":"Started At","examples":["2026-09-29T20:14:05Z"]},"ended_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ended At","description":"Null while ongoing. Equal to `started_at` for a reorg."},"duration_s":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration S","description":"`ended_at` minus `started_at`: for a folded entry, the span."},"measured_from":{"type":"string","title":"Measured From","examples":["btlabs-lon"]},"occurrences":{"type":"integer","title":"Occurrences","description":"How many times this happened to this subject within 24 hours of `started_at`. Repeats are folded into one entry rather than listed.","default":1,"examples":[7]},"last_started_at":{"type":"string","title":"Last Started At","description":"Start of the latest occurrence; `started_at` when there is one.","examples":["2026-10-13T12:13:32Z"]},"active_s":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Active S","description":"Seconds active, summed over closed occurrences."},"active_total_s":{"type":"integer","title":"Active Total S","description":"`active_s` plus the ongoing occurrence so far, if any.","default":0},"occurrence_times":{"items":{"$ref":"#/components/schemas/OccurrenceOut"},"type":"array","title":"Occurrence Times","description":"Up to the 50 newest occurrences."}},"type":"object","required":["id","kind","severity","subject","started_at","measured_from","last_started_at"],"title":"EventOut","description":"One incident. Conditions open and close; a reorg is an instant."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HealthResponse":{"properties":{"service":{"type":"string","title":"Service","examples":["epic-status"]},"version":{"type":"string","title":"Version","examples":["0.1.0"]},"prober_id":{"type":"string","title":"Prober Id","examples":["btlabs-lon"]},"has_data":{"type":"boolean","title":"Has Data"},"stale":{"type":"boolean","title":"Stale"},"generated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Generated At"}},"type":"object","required":["service","version","prober_id","has_data","stale"],"title":"HealthResponse","description":"Liveness of this monitoring service, not of the Epic Cash network.\n\nPoint alerting here. A 503 means the observer is broken; it says nothing about\nthe nodes, and conflating the two is the most damaging mistake a status page can\nmake."},"IconOut":{"properties":{"url":{"type":"string","title":"Url","description":"The largest rendition. Square PNG, transparent where the original was not square.","examples":["https://status.btlabs.uk/api/v1/icons/3f9c0a6d1b2e4c5f7a8b-256.png"]},"urls":{"additionalProperties":{"type":"string"},"type":"object","title":"Urls","description":"Every rendition, keyed by its width in pixels.","examples":[{"128":"https://status.btlabs.uk/api/v1/icons/3f9c0a6d1b2e4c5f7a8b-128.png","256":"https://status.btlabs.uk/api/v1/icons/3f9c0a6d1b2e4c5f7a8b-256.png"}]},"hash":{"type":"string","title":"Hash","description":"Content hash, also in the file names. A changed icon has a new hash, so it is a safe cache key.","examples":["3f9c0a6d1b2e4c5f7a8b"]},"updated_at":{"type":"string","title":"Updated At","examples":["2026-10-24T15:40:00Z"]}},"type":"object","required":["url","urls","hash","updated_at"],"title":"IconOut"},"ListMeta":{"properties":{"describes":{"type":"string","title":"Describes","description":"What the list contains, in one phrase.","examples":["Epic Cash mainnet public node endpoints"]},"filtered":{"type":"string","title":"Filtered","description":"Which subset this response holds. `healthy` means every entry answered its last check and, for nodes, is within the tip-lag threshold. `all` means every monitored target including the ones that are down.","examples":["healthy"]},"count":{"type":"integer","title":"Count","description":"Entries in this response.","examples":[3]},"total_monitored":{"type":"integer","title":"Total Monitored","description":"Targets of this kind being monitored, before filtering.","examples":[5]},"refreshed_every_s":{"type":"number","title":"Refreshed Every S","description":"Cadence of the checks behind this list. Polling faster gains nothing.","examples":[5.0]},"measured_from":{"type":"string","title":"Measured From","description":"Identifier of the probe these measurements were taken from. One vantage point: reachability and latency describe the path from this host.","examples":["btlabs-lon"]},"docs":{"type":"string","title":"Docs","description":"Human reference for this route.","examples":["https://status.btlabs.uk/api"]}},"type":"object","required":["describes","filtered","count","total_monitored","refreshed_every_s","measured_from","docs"],"title":"ListMeta","description":"What this list is, carried in the list.\n\nA bare array of URLs tells a consumer nothing about what it is holding: whether the\nset was filtered, how old it is, how often it changes, or where the measurements\nbehind it were taken. That knowledge used to live only in the prose on /api, which\nmeans a script that fetched the route had no access to it and a reader who found the\nroute through a search engine never saw it.\n\nEvery list route now answers those questions in the response. It is four extra keys\nand it removes the need for the page to explain the route at all."},"Location":{"properties":{"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","description":"ISO 3166-1 alpha-2.","examples":["FI"]},"country_registry":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Registry","description":"What the registry said, before any operator-supplied override.","examples":["FI"]},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City","examples":["Helsinki"]},"provider":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider","examples":["Hetzner"]},"network_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Network Name","description":"The registry's handle for the allocation. Often identifies the datacentre more precisely than the country does.","examples":["CLOUD-FSN1"]},"source":{"type":"string","title":"Source","default":"registry","examples":["registry"]}},"type":"object","title":"Location","description":"Where the host appears to be, from registry records.\n\nLow confidence by construction, which is why `source` is present and says\n`registry`. RDAP carries country inconsistently — some allocations have none at\nall — and a host behind a proxy or anycast reports the proxy's location. Never\ntreat this as a measurement."},"Network":{"properties":{"chain":{"type":"string","title":"Chain","description":"Which network this document describes: `mainnet` or `floonet`. One document per chain — request the other with `?chain=floonet`. The two are scored entirely separately, so no field here ever mixes them.","default":"mainnet","examples":["mainnet"]},"tip_height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Tip Height","examples":[3721218]},"tip_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tip Hash"},"tip_mined_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tip Mined At","description":"When the tip block was mined, from the block's own timestamp. Absolute, so it cannot go stale the way a rendered age does.","examples":["2026-09-22T19:20:54Z"]},"tip_age_s":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Tip Age S","description":"Age of the tip block, from its own timestamp. Catches a stalled chain, which height alone cannot.","examples":[64]},"health_score":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Health Score","description":"0–100, nodes only. Reachability 40%, tip agreement 35%, latency 15%, version spread 10%, and a flat −25 when forked. Epicbox is excluded: a dead relay breaks one transport, a forked chain breaks everything.","examples":[74]},"forked":{"type":"boolean","title":"Forked","description":"Only true after the same conflict persists across consecutive sweeps. A single sweep cannot tell a fork from a normal orphan race.","default":false},"fork_detail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fork Detail"},"nodes_total":{"type":"integer","title":"Nodes Total","default":0,"examples":[7]},"nodes_healthy":{"type":"integer","title":"Nodes Healthy","default":0,"examples":[3]},"nodes_degraded":{"type":"integer","title":"Nodes Degraded","default":0,"examples":[0]},"nodes_down":{"type":"integer","title":"Nodes Down","default":0,"examples":[4]},"epicbox_total":{"type":"integer","title":"Epicbox Total","default":0,"examples":[6]},"epicbox_healthy":{"type":"integer","title":"Epicbox Healthy","default":0,"examples":[3]},"epicbox_degraded":{"type":"integer","title":"Epicbox Degraded","default":0,"examples":[0]},"epicbox_down":{"type":"integer","title":"Epicbox Down","default":0,"examples":[3]},"pools_total":{"type":"integer","title":"Pools Total","default":0,"examples":[2]},"pools_healthy":{"type":"integer","title":"Pools Healthy","default":0,"examples":[2]},"pools_degraded":{"type":"integer","title":"Pools Degraded","default":0,"examples":[0]},"pools_down":{"type":"integer","title":"Pools Down","default":0,"examples":[0]},"median_node_latency_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Median Node Latency Ms","examples":[256]},"median_epicbox_latency_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Median Epicbox Latency Ms","examples":[748]},"median_pool_latency_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Median Pool Latency Ms","examples":[1564]},"countries":{"items":{"type":"string"},"type":"array","title":"Countries","examples":[["DE","FI","GB","US"]]},"providers":{"additionalProperties":{"type":"integer"},"type":"object","title":"Providers","description":"Count of listed services per hosting provider. Concentration here is a correlated-failure risk no single operator can fix.","examples":[{"Hetzner":6,"Vultr":4}]},"co_hosted_addresses":{"type":"integer","title":"Co Hosted Addresses","description":"Addresses serving more than one listed service — typically a node and a relay on one machine, which fail together.","default":0,"examples":[3]},"released_node_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Released Node Version","description":"The node version upstream has published. Deliberately not derived from what the fleet is running: the highest version seen across monitored nodes would score a uniformly out-of-date fleet as unanimous.","examples":["4.1.0"]},"released_node_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Released Node Source","description":"Where released_node_version came from: `github` (the latest non-draft, non-prerelease release, refreshed every few hours), `seed` (GitHub not reached yet; the committed fallback) or `pinned` (set by the operator).","examples":["github"]},"released_wallet_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Released Wallet Version","description":"The wallet version upstream has published.","examples":["4.1.0"]},"nodes_current":{"type":"integer","title":"Nodes Current","description":"Nodes reporting exactly released_node_version.","default":0,"examples":[2]},"nodes_versioned":{"type":"integer","title":"Nodes Versioned","description":"Nodes that reported any version — the denominator for nodes_current. A node with a closed foreign API answers get_tip but not get_version, so this is routinely lower than nodes_total.","default":0,"examples":[3]},"activity":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Activity","description":"Block intervals, the per-algorithm mix and difficulty, and reorgs over the last day, from block headers on the public API. Null until enough headers have been collected."}},"type":"object","title":"Network"},"NodeStatus":{"properties":{"id":{"type":"string","title":"Id","description":"Stable identifier.","examples":["node.epiccash.com"]},"kind":{"type":"string","title":"Kind","description":"`node`, `epicbox` or `pool`.","examples":["node"]},"host":{"type":"string","title":"Host","examples":["node.epiccash.com:3413"]},"endpoint":{"type":"string","title":"Endpoint","description":"What is actually contacted.","examples":["https://node.epiccash.com:3413"]},"operator":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Operator","examples":["Epic Cash"]},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Label","examples":["Default node"]},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"verified":{"type":"boolean","title":"Verified","description":"Vouched for by this instance's operator as an official server. False means community-run, which is an absence of vouching rather than a judgement.","default":false},"listing":{"type":"string","title":"Listing","description":"`official` or `community` — the same fact as `verified`, as the value the board groups by.","default":"community","examples":["official"]},"source":{"type":"string","title":"Source","description":"`seed` or `submitted`.","examples":["seed"]},"state":{"type":"string","title":"State","description":"`healthy`, `degraded`, `down`, or `unknown`. Three states rather than two: a node whose API needs credentials is up but unpollable, a node far behind the tip answers perfectly, and a probe that failed from this host is not proof about that one.","examples":["healthy"]},"reason":{"type":"string","title":"Reason","description":"Machine-readable cause when not healthy, e.g. `tip_lag`, `api_restricted`, `timeout`, `p2p_only`. A relay with a certificate near expiry is not one of these: it stays `healthy` with `ok`, and the day count is published on its own in `cert_expires_in_days`.","examples":["ok"]},"detail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Detail","description":"The same cause in a sentence, as shown on the board."},"latency_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Latency Ms","description":"Round trip from this prober only. A latency figure is a statement about the measuring host's network as much as the target's.","examples":[118]},"last_checked_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Checked At","examples":["2026-09-22T06:42:35Z"]},"last_ok_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Ok At","description":"Last successful check. Only ever moves forward, and only on success. Null means it has never answered.","examples":["2026-09-22T06:42:35Z"]},"last_error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Error","description":"Verbatim failure text, published so an operator can diagnose their own endpoint without contacting anyone.","examples":["connection timed out"]},"error_count":{"type":"integer","title":"Error Count","description":"Consecutive failures.","default":0,"examples":[0]},"uptime":{"$ref":"#/components/schemas/Uptime"},"location":{"$ref":"#/components/schemas/Location"},"icon":{"anyOf":[{"$ref":"#/components/schemas/IconOut"},{"type":"null"}],"description":"The server's icon, or null when it has none — show the host's initials then. Only icons an operator has approved appear here."},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Height","examples":[3721218]},"tip_lag":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Tip Lag","description":"Blocks behind the highest tip seen across the fleet. 0 is at the tip. This, not reachability, is what separates health from liveness.","examples":[0]},"tip_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tip Hash","description":"Tip block hash. Two nodes at one height with different hashes is how a fork becomes visible."},"node_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Node Version","examples":["4.0.4"]},"ipv6":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ipv6","description":"`yes` answered over IPv6; `unreachable` publishes an AAAA record that does not answer; `absent` has none. Null until first checked.","examples":["absent"]},"browser_access":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Browser Access","description":"Whether the CORS preflight a browser wallet sends is accepted. Null until checked, or when the preflight could not be completed.","examples":[true]},"peers":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Peers","description":"Connected peers, from the node's status call. Null when neither `/v1/status` nor owner `get_status` answered.","examples":[43]},"status_closed":{"type":"boolean","title":"Status Closed","description":"The operator has closed the status endpoints (HTTP 401/403).","default":false},"node_status":{"anyOf":[{"$ref":"#/components/schemas/NodeStatusCall"},{"type":"null"}],"description":"The latest status call. Null before the first one returns."}},"type":"object","required":["id","kind","host","endpoint","source","state","reason","uptime","location"],"title":"NodeStatus"},"NodeStatusCall":{"properties":{"ok":{"type":"boolean","title":"Ok","description":"Whether either status endpoint answered usably."},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source","description":"`v1_status` (GET /v1/status, Epic 4.1.0-1) or `owner_get_status` (the owner API's get_status, the fallback for a stock 4.1.0).","examples":["v1_status"]},"closed":{"type":"boolean","title":"Closed","description":"Every status endpoint answered 401 or 403: the operator has closed them on purpose. Not a fault; peers are then not public.","default":false},"derived_sync":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Derived Sync","description":"Only when `closed`: `at tip` or `N behind`, from the foreign API's get_tip height against the network tip.","examples":["at tip"]},"sync_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sync Status","examples":["no_sync"]},"user_agent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Agent","examples":["MW/Epic 4.1.0"]},"protocol_version":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Protocol Version","examples":[2]},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Height","examples":[3759223]},"tip_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tip Hash","description":"`tip.last_block_pushed`."},"tip_agrees":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Tip Agrees","description":"Whether tip_hash matches the most common hash of the other nodes at the same height. Null when no other node is at that height."},"awaiting_peers":{"type":"boolean","title":"Awaiting Peers","description":"sync_status has been `awaiting_peers` on two or more consecutive status calls. Informational only; it does not affect `state`.","default":false},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error","description":"Why neither endpoint answered, per endpoint."}},"type":"object","required":["ok"],"title":"NodeStatusCall"},"OccurrenceOut":{"properties":{"started_at":{"type":"string","title":"Started At","examples":["2026-10-13T12:13:32Z"]},"ended_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ended At","description":"Null while it lasts."}},"type":"object","required":["started_at"],"title":"OccurrenceOut","description":"One occurrence folded into an incident entry."},"PoolList":{"properties":{"meta":{"$ref":"#/components/schemas/ListMeta"},"generated_at":{"type":"string","title":"Generated At"},"pools":{"items":{"type":"string"},"type":"array","title":"Pools","examples":[["epicmine.io","epic.iniaku.my.id"]]}},"type":"object","required":["meta","generated_at"],"title":"PoolList"},"PoolStatus":{"properties":{"id":{"type":"string","title":"Id","description":"Stable identifier.","examples":["node.epiccash.com"]},"kind":{"type":"string","title":"Kind","description":"`node`, `epicbox` or `pool`.","examples":["node"]},"host":{"type":"string","title":"Host","examples":["node.epiccash.com:3413"]},"endpoint":{"type":"string","title":"Endpoint","description":"What is actually contacted.","examples":["https://node.epiccash.com:3413"]},"operator":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Operator","examples":["Epic Cash"]},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Label","examples":["Default node"]},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"verified":{"type":"boolean","title":"Verified","description":"Vouched for by this instance's operator as an official server. False means community-run, which is an absence of vouching rather than a judgement.","default":false},"listing":{"type":"string","title":"Listing","description":"`official` or `community` — the same fact as `verified`, as the value the board groups by.","default":"community","examples":["official"]},"source":{"type":"string","title":"Source","description":"`seed` or `submitted`.","examples":["seed"]},"state":{"type":"string","title":"State","description":"`healthy`, `degraded`, `down`, or `unknown`. Three states rather than two: a node whose API needs credentials is up but unpollable, a node far behind the tip answers perfectly, and a probe that failed from this host is not proof about that one.","examples":["healthy"]},"reason":{"type":"string","title":"Reason","description":"Machine-readable cause when not healthy, e.g. `tip_lag`, `api_restricted`, `timeout`, `p2p_only`. A relay with a certificate near expiry is not one of these: it stays `healthy` with `ok`, and the day count is published on its own in `cert_expires_in_days`.","examples":["ok"]},"detail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Detail","description":"The same cause in a sentence, as shown on the board."},"latency_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Latency Ms","description":"Round trip from this prober only. A latency figure is a statement about the measuring host's network as much as the target's.","examples":[118]},"last_checked_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Checked At","examples":["2026-09-22T06:42:35Z"]},"last_ok_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Ok At","description":"Last successful check. Only ever moves forward, and only on success. Null means it has never answered.","examples":["2026-09-22T06:42:35Z"]},"last_error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Error","description":"Verbatim failure text, published so an operator can diagnose their own endpoint without contacting anyone.","examples":["connection timed out"]},"error_count":{"type":"integer","title":"Error Count","description":"Consecutive failures.","default":0,"examples":[0]},"uptime":{"$ref":"#/components/schemas/Uptime"},"location":{"$ref":"#/components/schemas/Location"},"icon":{"anyOf":[{"$ref":"#/components/schemas/IconOut"},{"type":"null"}],"description":"The server's icon, or null when it has none — show the host's initials then. Only icons an operator has approved appear here."},"miners":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Miners","description":"Connected accounts.","examples":[118]},"workers":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Workers","description":"Connected rigs, which exceeds `miners`.","examples":[521]},"fee_percent":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Fee Percent","description":"Always a percentage. One pool publishes its fee as the fraction `\"0.02\"`; that is normalised here so the two are comparable.","examples":[2.5]},"last_block_height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Last Block Height","description":"The last block this pool **found** — not its chain tip, which no pool API exposes. Do not compare it with `network.tip_height`: the expected gap is inversely proportional to the pool's share, so a small pool is legitimately hundreds of blocks back while working perfectly.","examples":[3721267]},"last_block_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Block At","description":"When that block was found. The useful form of the field above.","examples":["2026-09-22T07:52:15Z"]}},"type":"object","required":["id","kind","host","endpoint","source","state","reason","uptime","location"],"title":"PoolStatus"},"Prober":{"properties":{"id":{"type":"string","title":"Id","examples":["btlabs-lon"]},"region":{"type":"string","title":"Region","examples":["GB"]},"measures":{"type":"string","title":"Measures","description":"What the figures from this probe describe, and what they do not.","examples":["reachability and round-trip latency from this host only"]}},"type":"object","required":["id","region","measures"],"title":"Prober","description":"Where the measurements were taken. One vantage point today; every stored check\ncarries this id from the first schema so a second region is additive."},"StatusMeta":{"properties":{"describes":{"type":"string","title":"Describes"},"states":{"additionalProperties":{"type":"string"},"type":"object","title":"States","description":"What each value of a target's `state` field means."},"fields":{"additionalProperties":{"type":"string"},"type":"object","title":"Fields","description":"Encoding and meaning for the fields that are not self-evident, so a consumer does not have to read the reference page to use them correctly."},"absent":{"items":{"type":"string"},"type":"array","title":"Absent","description":"Facts this API deliberately does not carry, and why."},"docs":{"type":"string","title":"Docs"},"schema":{"type":"string","title":"Schema","description":"The OpenAPI document for these routes."}},"type":"object","required":["describes","states","fields","absent","docs","schema"],"title":"StatusMeta","description":"What the payload is, inside the payload.\n\nPresent so a consumer that never reads the reference page still knows what the three\nstates mean and which facts are deliberately absent. Documenting that only in prose\nputs it out of reach of the scripts that actually consume this."},"StatusResponse":{"properties":{"meta":{"$ref":"#/components/schemas/StatusMeta"},"generated_at":{"type":"string","title":"Generated At","examples":["2026-09-22T06:42:35Z"]},"stale":{"type":"boolean","title":"Stale","description":"True when the poller has not completed a sweep recently. Frozen numbers presented as live are worse than an admission.","default":false},"prober":{"$ref":"#/components/schemas/Prober"},"network":{"$ref":"#/components/schemas/Network"},"nodes":{"items":{"$ref":"#/components/schemas/NodeStatus"},"type":"array","title":"Nodes"},"epicbox":{"items":{"$ref":"#/components/schemas/EpicboxStatus"},"type":"array","title":"Epicbox"},"pools":{"items":{"$ref":"#/components/schemas/PoolStatus"},"type":"array","title":"Pools"}},"type":"object","required":["meta","generated_at","prober","network","nodes","epicbox","pools"],"title":"StatusResponse"},"SubmitAccepted":{"properties":{"ok":{"type":"boolean","title":"Ok","default":true},"message":{"type":"string","title":"Message","examples":["node.example.org:3413 queued. It will be probed 3 times, 60 seconds apart."]}},"type":"object","required":["message"],"title":"SubmitAccepted"},"SubmitRejected":{"properties":{"ok":{"type":"boolean","title":"Ok","default":false},"error":{"type":"string","title":"Error","description":"Why it was refused, phrased to be actionable on its own.","examples":["node.example.org resolves to the non-public address 10.0.0.5"]}},"type":"object","required":["error"],"title":"SubmitRejected"},"Uptime":{"properties":{"1h":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"1H","examples":[1.0]},"24h":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"24H","examples":[0.9998]},"30d":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"30D","examples":[0.9971]}},"type":"object","title":"Uptime","description":"Fraction of successful checks in the window, or null when there is no data.\n\nNull is not zero. A target with no history has no uptime; rendering it as 0%\nwould misreport a server nobody has measured yet as one that is always down."},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"tags":[{"name":"status","description":"Read the current board."},{"name":"lists","description":"Endpoint lists for wallets and failover configs."},{"name":"service","description":"Health of this monitor, not of the network."},{"name":"submit","description":"Add a server to be monitored."}]}