Wallet API
Esplora-compatible REST API for TensorCash light wallets: balances, UTXOs, history, mempool, fee estimates and broadcast of already-signed transactions. Esplora is the API Blockstream and mempool.space serve, so wallet code written against it works by changing the base URL. Amounts are integer satoshis (1 TSC = 100 000 000). Errors are plain text with an HTTP status. While the index lags the node, address and transaction routes answer 503 Index syncing: n/m.
Blocks
Chain tip and block hashes, as plain text.
- GET/esplora/api/blocks/tip/heightTip height
- GET/esplora/api/blocks/tip/hashTip hash
- GET/esplora/api/block-height/{height}Block hash at a height
Transactions
Esplora transaction objects, status, raw hex, spends, and broadcast of a signed transaction.
- GET/esplora/api/tx/{txid}Transaction
- GET/esplora/api/tx/{txid}/statusTransaction status
- GET/esplora/api/tx/{txid}/hexRaw transaction hex
- GET/esplora/api/tx/{txid}/outspendsOutput spends
- POST/esplora/api/txBroadcast a signed transaction
Addresses
Per-address balances, UTXOs and history. Each GET answers from the server's current view.
- GET/esplora/api/address/{key}Address balance
- GET/esplora/api/address/{key}/utxoAddress UTXOs
- GET/esplora/api/address/{key}/txsAddress transactions
- GET/esplora/api/address/{key}/txs/chainConfirmed address transactions
- GET/esplora/api/address/{key}/txs/chain/{last_seen}Older confirmed address transactions
- GET/esplora/api/address/{key}/txs/mempoolUnconfirmed address transactions
Script hashes
The same six routes as Addresses, keyed by Electrum script hash: sha256 of the scriptPubKey, byte-reversed, hex.
- GET/esplora/api/scripthash/{key}Script hash balance
- GET/esplora/api/scripthash/{key}/utxoScript hash UTXOs
- GET/esplora/api/scripthash/{key}/txsScript hash transactions
- GET/esplora/api/scripthash/{key}/txs/chainConfirmed script hash transactions
- GET/esplora/api/scripthash/{key}/txs/chain/{last_seen}Older confirmed script hash transactions
- GET/esplora/api/scripthash/{key}/txs/mempoolUnconfirmed script hash transactions
Wallet batch
Not part of Esplora: many addresses per request, for HD wallets that track thousands of addresses. Responses carry a view that pins one chain tip and mempool copy across the calls of a sync.
- POST/esplora/api/wallet/addressesBalances and UTXOs of many addresses
- POST/esplora/api/wallet/historyMerged history of many addresses
Fees
Fee-rate estimates.
- GET/esplora/api/fee-estimatesFee estimates
Health
Index and node tips, outside the /esplora/api prefix.
- GET/healthIndex and node tips