Address Operations | Bitcoin

getInfo

Returns an address's confirmed-chain balance and transaction totals. Esplora nests these under separate chain_stats/mempool_stats objects; this node flattens to the confirmed-chain namespace only — use getTransactionsMempool for unconfirmed activity.

Field	Type	Required	Description
`address`	text	✓ Yes	Any valid Bitcoin address for the selected network.
`network`	select	No	Defaults to `Bitcoin:DefaultNetwork`.

Example response:

{
  "balanceSats": 1234500,
  "txCount": 7,
  "fundedTxoSum": 5000000,
  "spentTxoSum": 3765500
}

balanceSats = fundedTxoSum − spentTxoSum. All satoshi fields are 64-bit — real balances routinely exceed 32-bit integer range.

getTransactions

Returns the address's full transaction history, Esplora's own array shape returned as-is.

Field	Type	Required	Description
`address`	text	✓ Yes	Address to look up.
`network`	select	No	Defaults to `Bitcoin:DefaultNetwork`.

getTransactionsChain

Same history as getTransactions, paginated by last-seen txid — use this for addresses with more transactions than fit in one response page.

Field	Type	Required	Description
`address`	text	✓ Yes	Address to look up.
`lastSeenTxid`	text	No	Txid from the end of the previous page — omit for the first page.
`network`	select	No	Defaults to `Bitcoin:DefaultNetwork`.

getTransactionsMempool

Returns only the address's unconfirmed transactions currently sitting in the mempool.

Field	Type	Required	Description
`address`	text	✓ Yes	Address to look up.
`network`	select	No	Defaults to `Bitcoin:DefaultNetwork`.

getUtxos

Returns the address's spendable unspent transaction outputs (UTXOs) — feeds directly into psbt/build's coin selection.

Field	Type	Required	Description
`address`	text	✓ Yes	Address to look up.
`network`	select	No	Defaults to `Bitcoin:DefaultNetwork`.

Example response — an array of UTXOs:

[
  {
    "txid": "8f3c...e21a",
    "vout": 0,
    "valueSats": 500000,
    "confirmed": true,
    "blockHeight": 831422
  }
]

Response Field	Meaning
`confirmed`	Read from Esplora's nested `status.confirmed` field — a UTXO awaiting its first confirmation reports `false`.
`blockHeight`	Null when unconfirmed.

getInfo vs. getUtxos: Use getInfo for a quick balance check. Use getUtxos when you need the actual spendable outputs — it's the operation psbt/build effectively performs internally when you supply fromAddress instead of an explicit utxos[] list.