BTCintel
nodeok
tip971,672
mempool68,852 tx
node next1.08 sat/vB
retarget40 blocks
chainmainnet

Docs

Addresses and scripts

Address summaries keyed by the rendered address, history, unspent outputs, and the same summary by script hash.

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/address/{address}

Address summary

Balances and counts reflect the index tip; an address unknown to the index answers on_chain: false, never a 404. The intel siblings annotations (current claims, CC-4) and relations (about the entities named, never the address; P17) are absent when the deployment has no intel store (CC-6).

MCP tool
get_address — see For agents

Parameters

NameInTypeDescription
address requiredpathstringMainnet address; other networks answer 400 with an explanation.
includequerystring · one of "expired"expired to include expired and retracted claims in annotations (attributions and hop-0 stay current-only).

Response 200

Summary with the intel siblings.

schema
  • address string
  • type string
  • script_hash string
  • on_chain boolean — false when the index has no history (yet).
  • keyed_by string — Intel identity. Always address — annotations hang off the rendered string, not one script_hash.
  • scripts array of object — Each script_hash row that renders as this address string.
    • type string
    • script_hash string
    • tx_count integer
    • funded_sat integer
    • spent_sat integer
  • balance_sat integer
  • funded_sat integer
  • spent_sat integer
  • tx_count integer
  • first_height integer | null
  • last_height integer | null
  • annotations array of Claim — Current claims on the address (CC-4); absent when not computed.
  • relations array of Relation — Relations of the entities the claims name; about entities, never the address (P17).
    • claim_id string
    • kind string required · one of "relation"
    • about string · one of "entity"
    • version integer
    • content_sha256 string
    • citation string
    • from_entity object
      • id string
      • name string
      • kind string — entity:… concept.
    • to_entity object
      • id string
      • name string
      • kind string — entity:… concept.
    • type string — relation:… concept.
    • source object
    • fetch object
    • confidence object
    • validity object
    • evidence array of object

Errors

  • 400 — Malformed input (bad hex, wrong-network address, bad vout).

Example

curl -s https://api.btcintel.io/v1/address/bc1qz654h5qcqzalv6ltpxsk4ksdcc3e20wkedqntgnarv3a0t2e2p7scr48pl | jq '{address, type, script_hash}'

GET /v1/address/{address}/txs

Address history (newest first)

Parameters

NameInTypeDescription
address requiredpathstringMainnet address; other networks answer 400 with an explanation.
limitqueryinteger—
offsetqueryinteger—

Response 200

Height and net value per transaction.

schema
array of object
  • txid string — Canonical display byte order.
  • height integer
  • value_sat integer

Errors

  • 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/address/bc1qz654h5qcqzalv6ltpxsk4ksdcc3e20wkedqntgnarv3a0t2e2p7scr48pl/txs | jq

GET /v1/address/{address}/utxos

Unspent outputs

Parameters

NameInTypeDescription
address requiredpathstringMainnet address; other networks answer 400 with an explanation.

Response 200

UTXOs as of the index tip.

schema
array of object
  • txid string — Canonical display byte order.
  • vout integer
  • value_sat integer
  • height integer

Errors

  • 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/address/bc1qz654h5qcqzalv6ltpxsk4ksdcc3e20wkedqntgnarv3a0t2e2p7scr48pl/utxos | jq

GET /v1/scripthash/{hash}

Lookup by script hash

Parameters

NameInTypeDescription
hash requiredpathstring—

Response 200

Same shape as the address summary, or on_chain: false.

schema
  • address string
  • type string
  • script_hash string
  • on_chain boolean — false when the index has no history (yet).
  • keyed_by string — Intel identity. Always address — annotations hang off the rendered string, not one script_hash.
  • scripts array of object — Each script_hash row that renders as this address string.
    • type string
    • script_hash string
    • tx_count integer
    • funded_sat integer
    • spent_sat integer
  • balance_sat integer
  • funded_sat integer
  • spent_sat integer
  • tx_count integer
  • first_height integer | null
  • last_height integer | null
  • annotations array of Claim — Current claims on the address (CC-4); absent when not computed.
  • relations array of Relation — Relations of the entities the claims name; about entities, never the address (P17).
    • claim_id string
    • kind string required · one of "relation"
    • about string · one of "entity"
    • version integer
    • content_sha256 string
    • citation string
    • from_entity object
      • id string
      • name string
      • kind string — entity:… concept.
    • to_entity object
      • id string
      • name string
      • kind string — entity:… concept.
    • type string — relation:… concept.
    • source object
    • fetch object
    • confidence object
    • validity object
    • evidence array of object

Errors

  • 400 — Malformed input (bad hex, wrong-network address, bad vout).

Example

curl -s https://api.btcintel.io/v1/scripthash/<script hash, 64 hex> | jq '{address, type, script_hash}'