Docs Chain API Wallet API Merged history of many addresses Merged history of many addresses POST /esplora/api/wallet/history
Wallet API v1.0.0 · Wallet batch
Not part of Esplora. One list, newest first (block height, then position in the block); a transaction touching several of the addresses appears once. Each entry is the Esplora transaction object. The first page (cursor: null) also returns the unconfirmed transactions of these addresses, up to 200; while mempool_complete is true it is the whole unconfirmed set, so a refresh replaces the wallet's unconfirmed list. Later pages, requested with next_cursor and the same address set, read the chain only up to snapshot, so new blocks never shift entries between pages. If a reorganization removed the snapshot block the cursor expires (409). Limits: 1 to 500 addresses, limit 1 to 100, a page also ends early past 2 MB of JSON, 2 requests per second per IP (burst 30).
Example curl -X POST 'https://api.tensorcash.org/esplora/api/wallet/history' \
-H 'Content-Type: application/json' \
--data '{"addresses":["tc1qmvalge7mnhct9qj5uua8rn0dmjcyh6fmvrr46j"]}'Parameters No parameters.
Request body Responses Status Description Body 200One page of merged history 400Bad body, limit or cursor; a cursor made for another address set or view; more than 500 addresses 409Cursor expired: the chain reorganized; start again without a cursor410view expired413Body over 128 KB 502A node lookup failed 503Index syncing: n/m
Schemas WalletHistoryRequestField Type Required Description addressesstring[]Yes 1 to 500 addresses. limitinteger— Confirmed transactions per page. cursorstring | null— null for the first page, else the previous next_cursor. viewstring— Optional: the view of an earlier response from the same host.
WalletHistoryResponseField Type Required Description tipTip Yes viewstringYes snapshotTip Yes errorsAddressError []Yes One entry per invalid address; the rest of the request is still served. mempoolTransaction []— First page only: unconfirmed transactions, newest first, up to 200. mempool_completeboolean— First page only: false when mempool was cut. txsTransaction []Yes Confirmed, newest first. next_cursorstring | nullYes null when there is no older history.
TipField Type Required Description heightintegerYes hashstringYes
AddressErrorField Type Required Description addressstringYes errorstringYes Invalid address, or Too many unspent transaction outputs (>5000).
TransactionField Type Required Description txidstringYes versionintegerYes locktimeintegerYes vinTxIn []Yes voutTxOut []Yes sizeintegerYes Bytes. weightintegerYes Weight units. feeintegerYes Satoshis. statusTxStatus Yes
TxInField Type Required Description txidstringYes Spent transaction; 64 zeros for a coinbase input. voutintegerYes Spent output index; 4294967295 for a coinbase input. prevoutTxOut | nullYes The output this input spends; null for a coinbase input. scriptsigstringYes Input script, hex (the coinbase data for a coinbase input). scriptsig_asmstringYes is_coinbasebooleanYes witnessstring[]— Witness stack, hex items. Present when not empty. sequenceintegerYes
TxOutField Type Required Description scriptpubkeystringYes Output script, hex. scriptpubkey_asmstringYes Output script in bcore's asm format (not Esplora's OP_PUSHBYTES_n form). scriptpubkey_type"p2pkh" | "p2sh" | "v0_p2wpkh" | "v0_p2wsh" | "v1_p2tr" | "op_return" | "p2pk" | "multisig" | "anchor" | "unknown"Yes scriptpubkey_addressstring— Present when the script has an address. valueintegerYes Amount in satoshis.
TxStatusField Type Required Description confirmedbooleanYes False while the transaction is in the mempool. block_heightinteger— Confirmed only. block_hashstring— Confirmed only. block_timeinteger— Block timestamp, Unix seconds. Confirmed only.
Source tensorcash-wallet-api (tensorcash-api) v1.0.0 (772799e) · bobponey · MIT