Skip to main content
GET
/
api
/
v1
/
onchain
/
transactions
List on-chain transactions
curl --request GET \
  --url https://api.example.com/api/v1/onchain/transactions \
  --header 'Authorization: Bearer <token>'
[
  {
    "balance_change_sat": 123,
    "is_cpfp": true,
    "tx": "<string>",
    "txid": "<string>",
    "confirmation": {
      "hash": "<string>",
      "height": 1
    },
    "onchain_fee_sat": 1
  }
]

Authorizations

​
Authorization
string
header
required

Base64url-encoded auth token

Response

200 - application/json

Returns the on-chain transactions

​
balance_change_sat
integer<int64>
required

Net change to the wallet's balance: received - sent over wallet-owned outputs. Positive for inbound, negative for outbound, zero for self-spends with no net change.

​
is_cpfp
boolean
required

true when this tx spends a P2A fee anchor output — i.e. it is a CPFP child bumping its parent. In bark this typically means the wallet is fee-bumping an exit transaction.

​
tx
string
required
​
txid
string
required
​
confirmation
object

Some when the transaction is mined; None while still in the mempool.

​
onchain_fee_sat
integer<int64> | null

Total fee paid by the transaction, when known. None for txs whose foreign prevouts BDK has not indexed (e.g. inbound payments observed via the bitcoind-rpc sync path; esplora sync always populates prevouts).

Required range: x >= 0