Wallet API
Wallet App To Altbase API
The desktop wallet talks to the Altbase API for network status, balances, histories, fees, broadcasting, updates, prices, and encrypted privacy cache sync.
API v1Wallet API base
LocalNon-custodial wallet
NoSecret wallet data sent?
Secret wallet data means mnemonic or seed phrase, private keys, wallet password, WIF keys, or plaintext privacy-wallet cache.
| Endpoint | Purpose | Data sent by wallet | Secret wallet data sent? |
|---|---|---|---|
GET /health | Checks whether the API service is online. | No wallet data. | No |
GET /coins | Returns the coin identifiers registered by the running API server. | No wallet data. | No |
GET /prices | Returns the server's cached USD price snapshot and its update time. | No wallet address or seed data. | No |
GET /app/update | Checks whether a newer desktop wallet build is available. | Platform and installed app version. | No |
GET /:coin/network | Returns chain height, network state, and sync status for a coin. | Coin identifier in URL. | No |
GET /:coin/fee/estimate?blocks=N | Returns a cached fee estimate for the requested target; an optional force flag refreshes it. | Coin identifier and target block count. | No |
POST /:coin/validate | Validates whether an address format is accepted by the coin network. | Public address. | No |
POST /:coin/address/balance | Returns confirmed, pending, and spendable balance for one or more public addresses. | Public address or address list, plus optional force-refresh flag. | No |
POST /:coin/address/utxos | Returns unspent outputs used for local transaction planning and MAX amount calculation. | Public address or address list, plus optional force or fast flags. | No |
POST /:coin/address/history | Returns transaction history for display in the wallet. | Public address, pagination settings, and optional UTXO overlay flag. | No |
POST /:coin/address/mempool | Returns pending address activity when the coin adapter supports it. | Public address. | No |
POST /:coin/tx/broadcast | Broadcasts a transaction that was built and signed on the user's device. | Signed raw hex, or a serialized signed envelope for Qubic, Kaspa, and CKB. | No private key; signed payload only |
POST /:coin/account/tx-context | Returns account-chain context. Quai receives nonce, gas, and chain ID; Qubic receives the current tick target and zero-fee context. | Public from address, optional to address, optional value. | No |
POST /wallet/snapshot | Loads network, balances, and paginated history for multiple wallet coins in one request, with optional force refresh and UTXO history overlay. | Coin identifiers, public address lists, pagination, and requested snapshot options. | No |
POST /privacy/cache/get | Downloads encrypted local wallet cache for Epic or Zano restore acceleration. | Coin identifier and backup ID derived locally from the mnemonic. | No plaintext secret |
POST /privacy/cache/put | Uploads encrypted local wallet cache for Epic or Zano restore acceleration. | Coin identifier, backup ID, and AES-GCM encrypted cache blob. | Encrypted cache only |
Qubic, Kaspa, and CKB balances are kept in atomic units as decimal strings so large values do not lose precision. Their adapters also merge locally tracked pending sends into spendable balances, history, and mempool responses until the network confirms them or the pending record expires.