Docs
Chain and blocks
Status, the tip, blocks by height or hash and their transactions. Facts from btcintel's own index; the node tip rides along for confirmations.
Generated from openapi.yaml (Btcintel native API 0.1.0). Every hash is canonical display order; every answer carries the index and node heights; errors use one envelope — see Semantics.
- GET
/v1/status— Chain, node and mempool status - GET
/v1/blocks— Recent blocks - GET
/v1/blocks/tip/height— Index tip height - GET
/v1/blocks/tip/hash— Index tip hash - GET
/v1/blocks/{id}— Block by height or canonical hash - GET
/v1/blocks/{id}/txs— Txids of a block - GET
/v1/blocks/{id}/status— Block chain-status
GET /v1/status
Chain, node and mempool status
- MCP tool
get_status— see For agents
Response 200
Index tip, live node info, mempool summary, fee estimates.
Headers: X-Btcintel-Index-Height, X-Btcintel-Node-Height
schema
communityobject — Spec S4.1 §8: the embedded relay and the ingester. Absent when neither runs on this deployment.relayobjecturlstringconnectionsintegerwrite_enabledbooleanmin_powinteger — The effective proof-of-work floor (24 while attack_mode is on).attack_modeboolean
ingestobject — One entry per public relay the ingester follows.relaysarray of objecturlstringconnectedbooleansincestring | null (date-time) — The newest created_at seen.events_totalintegerlast_errorstring | null
publishobject — Spec S5.1 FR-8: the API write path — whether it is open (WRITES_ENABLED) and the outbound relays.enabledbooleanqueuedinteger — The deepest backlog among the outbound relays; each relay has its own queue and worker (codex#111).dropped_totalintegerrelaysarray of objecturlstringconnectedbooleansent_totalintegerfailed_totalintegerqueuedinteger
signerobject — The custodied signer (spec S5.6 §5): counts only. Absent when the deployment runs without one or it does not answer.keysinteger required — Live custodied keys.clientsinteger required — NIP-46 apps connected to them.signingboolean required — The signer signs and exports (SIGNING_ENABLEDon its side).bunkerboolean required — The signer listens on the relay for NIP-46 requests.
featuresobject — Routes a client may switch on when present (spec S3.4); a key absent here means the deployment predates the route.feedbackboolean —POST /v1/feedbackis served; the web renders its feedback sheet.sessionsboolean — The NIP-98 login and the session cookie are served (spec S5.1 FR-1).login_nonceboolean —GET /v1/auth/nonceis served and the login reads thenoncetag (spec S5.8); absent on a deployment that predates it.writesboolean — The API write path is open: publish, delete, propose (spec S5.1 §10; on since CP3, P60).accountsboolean — Sign-up and sign-in with an e-mail account, the t4 band, are served (spec S5.5 §10;ACCOUNTS_ENABLED).sign_inarray of string — The sign-in providers configured (spec S5.5 FR-13, phase D) while accounts are on; empty otherwise. The web renders one button per entry.signingboolean — The custodied signer signs and exports (spec S5.6 §10;SIGNING_ENABLED, off until CP4).
intelobject — Intel pipeline: active sources and the latest fetch per source (fetched_at, sha256, status, last_error).sources_activeintegersources_totalintegerpushboolean — The push endpoint is configured.schedulerboolean — The in-process fetch scheduler is running.last_fetchobject
chainstringtip_heightinteger — Index tip.tip_hashstring — Canonical display byte order.bitcoind_heightinteger — Live node tip.bitcoind_okbooleanbitcoindobject — Subset of getblockchaininfo.network_hashpsnumbermempool_sizeinteger — getmempoolinfo.size, not the mirrored sample.mempoolobjectsizeintegerbytesintegerusageintegertotal_feeinteger — satsmempoolminfeenumber — sat/vBminrelaytxfeenumber — sat/vB
fee_estimatesobject — estimatesmartfee sat/vB by confirmation target ("1", "3", "6").updated_atstring (date-time)
Errors
401— Missing or invalid bearer (unauthorized).
Example
curl -s https://api.btcintel.io/v1/status | jq '{chain, tip_height, tip_hash}'GET /v1/blocks
Recent blocks
Parameters
| Name | In | Type | Description |
|---|---|---|---|
limit | query | integer · ≤ 50 · default 10 | — |
start_height | query | integer | Defaults to the index tip. |
Response 200
Blocks, newest first.
schema
Example
curl -s https://api.btcintel.io/v1/blocks | jqGET /v1/blocks/tip/height
Index tip height
Response 200
Height the index has reached (not the node tip).
schema
heightinteger
Example
curl -s https://api.btcintel.io/v1/blocks/tip/height | jqGET /v1/blocks/tip/hash
Index tip hash
Response 200
Canonical hash of the index tip.
schema
hashstring — Canonical display byte order.
Example
curl -s https://api.btcintel.io/v1/blocks/tip/hash | jqGET /v1/blocks/{id}
Block by height or canonical hash
- MCP tool
get_block— see For agents
Parameters
| Name | In | Type | Description |
|---|---|---|---|
id required | path | string | Height (decimal) or canonical block hash (64 hex). |
include | query | string · one of "expired" | expired to include expired and retracted claims in annotations (attributions and hop-0 stay current-only). |
Response 200
Block header facts with the intel siblings.
schema
BlockDetail
Errors
301— Legacy internal-order hash; Location holds the canonical URL.400— Malformed input (bad hex, wrong-network address, bad vout).404— Unknown to the index and, for transactions, to the node mempool.
Example
curl -s https://api.btcintel.io/v1/blocks/968212 | jqGET /v1/blocks/{id}/txs
Txids of a block
Parameters
| Name | In | Type | Description |
|---|---|---|---|
id required | path | string | Height (decimal) or canonical block hash (64 hex). |
Response 200
Canonical txids in block order.
schema
heightintegertxidsarray of string
Errors
301— Legacy internal-order hash; Location holds the canonical URL.404— Unknown to the index and, for transactions, to the node mempool.
Example
curl -s https://api.btcintel.io/v1/blocks/968212/txs | jqGET /v1/blocks/{id}/status
Block chain-status
Parameters
| Name | In | Type | Description |
|---|---|---|---|
id required | path | string | Height (decimal) or canonical block hash (64 hex). |
Response 200
Whether the block is in the best indexed chain and its successor.
schema
in_best_chainbooleanheightintegerhashstring — Canonical display byte order.next_beststring — Canonical display byte order.
Errors
404— Unknown to the index and, for transactions, to the node mempool.
Example
curl -s https://api.btcintel.io/v1/blocks/968212/status | jq '{in_best_chain, height, hash}'