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

Docs

Transactions

A transaction with resolved inputs and outputs, its confirmation status and the spend status of its outputs.

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/tx/{txid}

Transaction by canonical txid

Confirmed and indexed → TxDetail (tx plus the intel siblings). In the node mempool → {txid, mempool: true, fee_sat, vsize, first_seen}. Confirmed but above the index tip → 409 not_indexed_yet. Unknown → 404. tx.confirmations counts against the node tip, never the index tip.

MCP tool
get_tx — see For agents

Parameters

NameInTypeDescription
txid requiredpathstringCanonical txid (64 hex, display byte order).
includequerystring · one of "expired"expired to include expired and retracted claims in annotations (attributions and hop-0 stay current-only).

Response 200

Confirmed (indexed) or mempool transaction.

schema
  • TxDetail — A confirmed transaction with the intel siblings of spec S1.6 FR-1. Every sibling is absent when not computed (no intel store) and an empty list when computed with nothing found (CC-6). classification arrives with S1.8.
    • tx Tx required
      • txid string — Canonical display byte order.
      • height integer
      • index integer | null — Position in the block; null when the backing index does not expose it (vigia mode).
      • version integer
      • locktime integer
      • size integer
      • weight integer
      • fee_sat integer — 0 for coinbase; subsidy is not a fee.
      • coinbase boolean
      • confirmations integer — Against the node tip (P0-3).
      • status object
        • confirmed boolean
        • block_height integer
      • vin array of object
        • vin integer
        • prev_txid string — Canonical txid of the spent output; empty for a coinbase input.
        • prev_vout integer | null — null for a coinbase input.
        • value_sat integer
        • address string | null
        • sequence integer
      • vout array of object
        • vout integer
        • value_sat integer
        • address string | null
        • type string
        • spent boolean
        • spent_txid string — Canonical txid of the spending transaction; empty while unspent.
    • annotations array of Claim — Current claims on the transaction (CC-4).
    • relations array of Relation — Relations of the entities the claims name; about entities, never the transaction (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
    • exposure Exposure — Read-time exposure from current annotations on the addresses the transaction touches; never walks further than the transaction itself.
      • hop0 array of Hop0 required
        • direction string required — in: the claim is on an address the transaction spends from; out: on an address it pays to. · one of "in", "out"
        • amount_sat integer required — Sats the address moved in that direction across every input or output of the transaction.
        • claim_id string required
        • citation string — CC-5 citation of the claim's current version.
        • label string
        • subject Subject required

          …

      • truncated boolean — Present and true when the transaction touches more than 1000 distinct addresses and only the first 1000 were looked up.
    • classification Classification — The tx-obs-v1 result (spec S1.8 FR-7); the same object as GET /v1/tx/{txid}/classification.
      • observations array of TxObservation required
        • kind string required · one of "op_return", "meta_protocol", "coinjoin", "feature", "pattern"
        • value string required — The rule that matched: omni, opentimestamps, runes, counterparty, …, inscription, src20_stamp, atomicals, whirlpool, wasabi-1, wabisabi, joinmarket, locktime_recent, bip69, rbf_signal, patoshi.
        • detail object required — Rule evidence: prefix_hex / text / heuristic for OP_RETURN, content_type for inscriptions, inputs / outputs / equal_outputs / denomination for CoinJoin patterns, nonce_lsb / extranonce for Patoshi.
        • extractor string required · one of "tx-obs"
        • extractor_version string required · one of "v1"
      • extracted_at string (date-time) required
      • extractor string · one of "tx-obs-v1"
  • MempoolTxDetail
    • txid string required — Canonical display byte order.
    • mempool boolean = true required
    • confirmations integer = 0
    • fee_sat integer
    • vsize integer
    • first_seen string (date-time)

Errors

  • 301 — Legacy internal-order txid; 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.
  • 409 — Confirmed on the node but the index has not reached its block yet.

Example

curl -s https://api.btcintel.io/v1/tx/71e4dae29ed1bc9fe008bba7f3542fd5961b780c220ca8778100a7cb8bd4c81b | jq

GET /v1/tx/{txid}/status

Confirmation status

Parameters

NameInTypeDescription
txid requiredpathstringCanonical txid (64 hex, display byte order).

Response 200

Confirmed (block hash/height, confirmations vs node tip) or mempool.

schema
  • confirmed boolean
  • block_height integer
  • block_hash string — Canonical display byte order.
  • confirmations integer

Errors

  • 404 — Unknown to the index and, for transactions, to the node mempool.

Example

curl -s https://api.btcintel.io/v1/tx/71e4dae29ed1bc9fe008bba7f3542fd5961b780c220ca8778100a7cb8bd4c81b/status | jq '{confirmed, block_height, block_hash}'

GET /v1/tx/{txid}/outspends

Spend status of every output

Parameters

NameInTypeDescription
txid requiredpathstringCanonical txid (64 hex, display byte order).

Response 200

One entry per vout, in order.

schema
array of Outspend
  • spent boolean required
  • txid string — Canonical display byte order.
  • vin integer
  • status object
    • confirmed boolean
    • block_height integer

Errors

  • 404 — Unknown to the index and, for transactions, to the node mempool.

Example

curl -s https://api.btcintel.io/v1/tx/71e4dae29ed1bc9fe008bba7f3542fd5961b780c220ca8778100a7cb8bd4c81b/outspends | jq

GET /v1/tx/{txid}/outspend/{vout}

Spend status of one output

Parameters

NameInTypeDescription
txid requiredpathstringCanonical txid (64 hex, display byte order).
vout requiredpathinteger · ≥ 0—

Response 200

Spend status.

schema
  • spent boolean required
  • txid string — Canonical display byte order.
  • vin integer
  • status object
    • confirmed boolean
    • block_height integer

Errors

  • 404 — Unknown to the index and, for transactions, to the node mempool.

Example

curl -s https://api.btcintel.io/v1/tx/71e4dae29ed1bc9fe008bba7f3542fd5961b780c220ca8778100a7cb8bd4c81b/outspend/0 | jq '{spent, txid, vin}'