REST Version & Health
REST endpoints for version and health
GET /version
Section titled “GET /version”Returns version information for blockd and connected services. Available before blockd
reaches ready state.
GET /versionResponse:
{ "blockd": { "version": "0.3.0-alpha.1", "name": "my-node" }, "core": { "network": "signet", "version": 290000, "subversion": "/Satoshi:29.0.0/" }, "indexer": { "version": "Fulcrum 2.0", "protocol": "1.4" }}| Field | Description |
|---|---|
blockd.name | Optional configurable string. See Server Configuration |
core.version | Integer version format — 290000 = 29.0.0 |
core.subversion | Raw user agent string from bitcoind’s getnetworkinfo |
core.network | Active chain, auto-detected at startup. See Network detection |
indexer.version | Version string returned by Fulcrum |
indexer.protocol | Protocol version returned by Fulcrum |
GET /health/{level}
Section titled “GET /health/{level}”Returns server health. Available before ready state — suitable for readiness probes.
Level controls response verbosity; numeric and named aliases are equivalent.
| Level | Alias | Description |
|---|---|---|
0 | basic | Server state only |
1 | tip | Adds current block tip |
2 | detailed | Adds bitcoind and indexer status |
GET /health # defaults to level 0 (basic)GET /health/0GET /health/basicGET /health/1GET /health/tipGET /health/2GET /health/detailedFor the complete health response schema, field reference, state tables, IBD fields, and ZMQ monitoring documentation, see Health & IBD Reference.