Upstream APIs
Altbase API Server Routes
The API server exposes normalized routes to the wallet and translates them into coin-specific node, explorer, or index requests.
RPCUpstream APIs
CachePrice Data APIs
NoSecret wallet data sent?
| Server route group | Responsibility | Notes |
|---|---|---|
/api/v1/:coin/network | Network height, chain state, and sync status. | Backed by coin node RPC, Blockbook, Quai RPC, Qubic tick data, Kaspa DAG data, CKB RPC, or privacy node adapters. |
/api/v1/:coin/address/* | Balance, UTXOs, history, and mempool activity for public addresses. | Short-lived read caches reduce upstream load. Force refresh, pagination, address expansion, UTXO fallback, and pending transaction reconciliation are supported where applicable. |
/api/v1/:coin/tx/broadcast | Submits locally signed transactions to the network. | Traditional UTXO adapters accept raw hex; Qubic, Kaspa, and CKB accept serialized signed envelopes. The server never signs them. |
/api/v1/:coin/account/tx-context | Returns account-chain transaction context. | Quai returns nonce, gas, and chain ID. Qubic returns a target tick twelve ticks ahead with zero-fee context. |
/api/v1/wallet/snapshot | Batch endpoint for startup and refresh data. | Combines prices, network state, balances, and paginated history; preserves atomic string balances and can fall back to UTXO totals. |
/api/v1/privacy/* | Encrypted cache storage and privacy scan/broadcast support. | Plain mnemonics and private keys are not accepted by these routes. |
/api/v1/app/update | Desktop app update metadata. | The wallet directs users to the official download page. |
The server has CORS enabled for JSON API responses, applies request size limits, rate limits clients by IP, and uses short cache TTLs for high-frequency blockchain data.
Server To Coin Nodes And Explorers
These upstream APIs are called by the Altbase server, not directly by the desktop wallet in normal use. Exact production node URLs and RPC credentials are configured on the server and are not shipped in the client source.
| Adapter | Upstream API type | Methods or paths used | Purpose |
|---|---|---|---|
bitcoin-rpc | Bitcoin Core / Dash-like JSON-RPC over HTTP(S) with server-side Basic Auth. | getblockchaininfo, getnetworkinfo, getmempoolinfo, getaddressbalance, getaddressutxos, getaddresstxids, scantxoutset, sendrawtransaction, validateaddress, estimatesmartfee. | UTXO coin network, address, history, fee, validation, and broadcast data. |
blockbook | Blockbook-compatible REST API. | /, /tx/:txid, /address/:address, /utxo/:address, /sendtx/:hex, /estimatefee/:blocks. | Blockbook coins such as Neoxa and Pearl. |
quai-rpc | Quai JSON-RPC plus Quaiscan-compatible explorer endpoints. | quai_blockNumber, quai_getBalance, quai_getTransactionCount, quai_sendRawTransaction, /api/v2/addresses/:address, /api/v2/addresses/:address/transactions. | Quai balance, gas, nonce, broadcast, and history. |
qubic-api | Qubic live and query REST APIs. | /tick-info, /balances/:identity, /getTransactionsForIdentity, /broadcast-transaction. | Qubic tick state, atomic balance, identity history, zero-fee target tick context, pending reconciliation, and broadcast. |
kaspa-api | Kaspa public REST API. | /info/blockdag, /info/kaspad, /info/fee-estimate, /addresses/:address/balance, /addresses/:address/utxos, /addresses/:address/full-transactions-page, /transactions. | Kaspa DAG state, atomic balance, UTXOs, full history, fee estimate, pending reconciliation, and broadcast. |
ckb-indexer | Failover CKB JSON-RPC plus Nervos explorer REST API. | get_tip_header, get_cells, get_transaction, send_transaction, /addresses/:address, /address_transactions/:address. | CKB tip state, exact-lock empty live cells, atomic balance, history, pending reconciliation, and signed cell transaction broadcast. |
remote-api | Another Altbase-compatible API base URL. | Forwards normalized routes such as network, address balance, address UTXOs, address history, broadcast, fee estimate, and privacy routes. | Allows a coin to be served by a separate compatible backend. |
zano-node | Zano node JSON-RPC and compact light index. | getinfo, get_tx_details, get_blocks_details.Raw proxy paths used by the local light wallet are also supported. | Zano network status and scan data for the local native privacy wallet. |
epic-node | Epic node HTTP API. | /v1/status, /v2/foreign.Related owner and foreign proxy routes are used when configured. | Epic network status and node interaction for the local native Epic wallet. |
CKB broadcast converts the locally signed SDK transaction into node RPC field names, including depGroup to dep_group, before send_transaction. No signing occurs on the server.
Price Data APIs
The desktop wallet requests prices from the Altbase API only. The server fetches prices from external providers, caches them, and returns a normalized result to the wallet.
| Provider | Endpoint pattern in source | Coins mapped in source | Purpose |
|---|---|---|---|
| LiveCoinWatch | POST https://api.livecoinwatch.com/coins/single | BTC, BC2, BCH2, FIRO, PEPE, KRGN, SCASH, NEOX, TRC, JKC, RTM, QUAI | USD market price source with primary and backup API-key retry on rate limiting. |
| NonKYC | https://nonkyc.io/api/v2/ticker/{pair} | CAP, EPIC, ZANO | Pair ticker source for coins traded there. |
| NestEx | https://trade.nestex.one/api/cg/tickers/{pair} | LC2 | LitecoinII market price source. |
| SafeTrade | https://safe.trade/api/v2/peatio/public/markets/{pair}/tickers | PRL | Pearl market price source. |
| CoinPaprika | https://api.coinpaprika.com/v1/tickers/{coinId} / /v1/coins/{coinId}/markets | HRC, MYDOGE, BTGS; PRL market fallback | Direct ticker prices for three assets and SafeTrade PRL/USDT fallback through the markets endpoint. |
| CoinGecko | https://api.coingecko.com/api/v3/simple/price | BTC, QUAI, QUBIC, CKB, KAS | Public no-key USD source for the newly integrated chains and supported Bitcoin and Quai mappings. |
The price feed refreshes on server startup and every five minutes. A failed provider request leaves the last successful cached value in place; the wallet reads only the normalized /api/v1/prices snapshot.
Market API keys, when required, are configured on the server. They are not included in the desktop wallet.
Public Links And Explorers
The source also contains public website and explorer links used for downloads, support, legal pages, or opening transactions and addresses outside the wallet.
| URL | Used for |
|---|---|
https://altbase.io/download | Official download page shown by the app update flow. |
https://altbase.io/downloads | Server-side default base for published desktop update files. |
https://altbase.io | Public website link shown in wallet settings. |
https://altbase.io/support | Support link shown in wallet settings. |
https://altbase.io/terms | Terms link shown in wallet settings. |
https://explorer.bitcoin2.org | Bitcoin2 explorer link. |
https://explorer.firo.org | Firo explorer link. |
https://pepeblocks.com | Pepecoin explorer link. |
https://explorer.hypercoin.network | Hypercoin explorer link. |
https://explorer.mydogecoin.fun | Mydogecoin explorer link. |
https://explore.bitcoingold.site | BTGS Coin explorer link. |
https://quaiscan.io | Quai explorer and transaction history fallback source. |
https://blockbook.pearlresearch.ai | Pearl Blockbook/explorer source. |
https://explorer.qubic.org | Qubic explorer link. |
https://explorer.nervos.org | Nervos explorer link. |
https://explorer.kaspa.org | Kaspa explorer link. |
Source Files Reviewed
The API behavior above is based on these source files:
src/services/coinApiService.tssrc/services/appUpdateService.tssrc/services/walletSnapshotService.tssrc/services/coinTxService.tssrc/services/quaiWalletService.tssrc/services/qubicWalletService.tssrc/services/kaspaWalletService.tssrc/services/ckbWalletService.tssrc/services/privacyCacheService.tssrc/services/nativeCoreService.tssrc/services/coinService.tssrc/wallet-engines/registry.tssrc/wallet-engines/utxo/utxoEngine.tssrc/wallet-engines/account/quaiEngine.tssrc/wallet-engines/account/qubicEngine.tssrc/wallet-engines/utxo/kaspaEngine.tssrc/wallet-engines/cell/ckbEngine.tssrc/wallet-engines/privacy/privacyEngine.tsserver/gateway.cjsserver/config/default.cjsserver/adapters/index.cjsserver/adapters/bitcoinFork.cjsserver/adapters/blockbook.cjsserver/adapters/remoteApi.cjsserver/adapters/quaiRpc.cjsserver/adapters/qubicRpc.cjsserver/adapters/kaspaRest.cjsserver/adapters/ckbRpc.cjsserver/adapters/zanoNode.cjsserver/adapters/epicNode.cjsserver/lib/priceFeed.cjsserver/lib/rpc.cjsserver/lib/utxoReadProfiles.cjsserver/lib/zanoLightIndex.cjsnative/core/src/privacy_light_wallet.cppnative/epic_core/src/lib.rsnative/vendor/epic_wallet_src/impls/src/adapters/epicbox.rs
Deployment-specific production RPC URLs, node credentials, and API keys are intentionally not listed here because they are loaded from server configuration files and should not be published.