Read our books, programmatically

Latest signed attestation: total reserves, TSD circulating supply, collateralization, cold/hot split, and breakdowns by chain, token and address group. Falls back to a live scan before the first attestation exists.

The append-only signed series behind the charts on /reserves. Each point carries its payload hash and signature so you can prove a historical value was never edited.

Aggregator-shaped supply data: symbol, chain, Omni property id, circulating supply, backing assets, reserves and collateralization.

Peg health, fee/limit configuration, instant redemption capacity per chain, redemption queue depth, and background job heartbeats.

Live flag, minimum/maximum order sizes, the global redemption fee in basis points, and an `account` block for the member behind your key: their permanent TEXITcoin deposit address, permanent EVM address, saved cash-out address, and their effective (possibly discounted or zero) fee.

The reusable TEXITcoin deposit address for the member behind your key (safe to cache and display as “your TSD address”), plus their permanent EVM address, saved cash-out address, and effective fee. All fee fields are numbers: redeemFeeBps, defaultRedeemFeeBps, feePercent.

The USDC payout address saved on the member’s account, plus their permanent TEXITcoin deposit address and effective fee. Use this to auto-fill both sides of a cash-out without asking the user to look anything up.

Save the USDC destination for this member once; afterwards every order may omit payoutAddress. An explicit payoutAddress on an order still overrides it for that order.

{"payoutAddress":"0x…"}

Check whether a coupon code is valid and see the fee it would apply. Never consumes a use.

{"code":"EARLYBIRD"}

Start a TSD → USDC redemption on behalf of your user. The response tells you exactly where the user must send TSD: depositAddress (also returned as address, txcDepositAddress and sendTo — same value), with asset: "TSD", network: TEXITcoin Omni property 39, and memo: null (Omni has no memo/tag). Show that address, not the account-level one. payoutAddress and refundAddress are optional — we fall back to the cash-out address and permanent TEXITcoin address on your account, and an explicit payoutAddress always overrides the account default. The member’s negotiated fee is applied automatically (a coupon can only lower it).

{"amount":100,"payoutAddress":"0x…","refundAddress":"TXC…","chain":"ethereum","couponCode":"EARLYBIRD","source":"HME Wallet"}

Read the current status, the deposit address to send TSD to (depositAddress / address / sendTo), amount received, payout amount, and settlement txids. Only the API key that created the order can read it.

Every 1:1 USD-backed token this desk issues on TEXITcoin — TSD (Texas Stable Dollar) and CAN (CannabisCoins.com) — with its Omni property id, accepted deposit stablecoins, min/max order size, mint and redeem fees in bps, circulating supply and whether it is live. No key required: poll this to build your UI and to disable submit when a token is paused or not yet issued.

One shape for every token. direction 'mint' takes a stablecoin deposit (USDC/USDT/PYUSD/DAI on Ethereum, Base or BNB Smart Chain) and grants the token to a legacy T… TEXITcoin address; the response carries the freshly derived deposit address. direction 'redeem' returns the token to the issuer and pays out USDC to payoutAddress; the response tells you where to send it. Poll the order with the cash-out order endpoint.

{
  "asset": "CAN",
  "direction": "mint",
  "chain": "base",
  "token": "USDC",
  "recipient": "T…",
  "amount": 250
}

Registry of every major we wrap: base and wrapped symbol, network, Omni property id, required confirmations, min/max order size, wrap and unwrap fees in bps, whether the desk is live, plus live reserves, wrapped supply and collateralization. No key required — poll this to build your UI and to disable submit when a desk is paused.

direction is 'wrap' (native in, wrapped out) or 'unwrap' (wrapped in, native out). For a wrap, payoutAddress is the customer's legacy T… TEXITcoin address and the response carries the per-order deposit address on the base chain. For an unwrap, payoutAddress is their BTC/LTC/ETH address and the response tells you where to send the wrapped token. refundAddress and reference are optional; reference is echoed back on every poll.

{
  "direction": "wrap",
  "asset": "BTC",
  "amount": 0.01,
  "payoutAddress": "T…",         // legacy TEXITcoin address
  "refundAddress": "bc1…",       // optional
  "reference": "seeds:order:123" // optional, echoed back
}

Current status, deposit address (depositAddress / sendTo), amounts, confirmations vs required, fee, and every txid (deposit, mint, burn, payout). Accepts the uuid or the TX-XXXXXXXX short reference. Polling also nudges the order forward, so state is fresh. Only the key that created the order can read it.

The QR a member shows in their TSD Swap account encodes this URL. Fetch it with Accept: application/json to get the manifest, or render the page and read the <script type="hm-link-xpubs"> block. It tells you what to sign, which chains we want, who is asking, when the challenge expires, and whether re-binding a new wallet is allowed. Tokens are single-use and live 5 minutes.

Send the manifest payload back with a BIP-137 signature over canonicalJson(payload) — keys sorted recursively, no whitespace, UTF-8 bytes, TEXITcoin magic prefix, base64 — signed by m/44'/696969'/0'/0/0. xpubs.TXC is required and must be the account-level extended public key (watch-only); xpubs.EVM is required (plain 0x address or an EVM xpub, where m/0/0 is taken) and becomes the member's automatic USDC redemption payout address; xpubs.BASE is optional and defaults to EVM. We verify the signature, store the xpub, auto-fill the member's TSD and USDC payout addresses, start watching every derived address for TSD, and return a freshly minted partner API key in api_key (scopes cashout + rewards) — so a single scan both links the wallet and authorises the app, replacing any pasted key. The key is shown once; rescanning issues a new one and revokes the previous one. 401 invalid signature, 409 wallet already linked to another account, 403 unknown_signer when re-binding without consent, 410 token used or expired.

{
  "payload": {
    "v": 1,
    "type": "hm-link-xpubs",
    "challenge_id": "<from manifest>",
    "from": "tsd.honest.money",
    "callback_url": "https://tsd.honest.money/api/public/v1/wallet-link?token=…",
    "chains": ["TXC", "EVM", "BASE"],
    "xpubs": {
      "TXC":  "xpub…",   // required — account xpub, watch-only
      "EVM":  "0x…",     // required — default EVM wallet (or an xpub)
      "BASE": "0x…"      // optional — defaults to EVM
    },
    "wallet": "HME Wallet",
    "exp": 1767225600,
    "issued_at": "2026-09-04T09:32:01.234Z"
  },
  "signature": "<base64 BIP-137>",
  "address": "T…"        // signing address, legacy base58
}

For mineHME level-up rewards. address can be any address we can tie back to a member: their signing address, any address derived from their linked xpub, their permanent TSD Swap inbox, or their linked ETH/Base address. Returns currentBalance, averageDailyBalance over the window, sample count, and which field matched. Balances are Omni TSD (property 39) sampled hourly, so the average can't be gamed by topping up once a day. Requires a key with the 'rewards' scope. Never returns an email or any other personal data.