REST API

BTCw price and OracleAMM status. No parameters.

curl -s https://btcw.tech/api/price

BTCw and USDw in a compact wallet format: symbol, name, address (null for native BTCw), native, decimals, price_usd, logo. The 321 price-tracker tokens are at /api/v2/swap/assets.

The 322 ClpPools pools (BTCw hub). Returns { updated, pools: [...] }.

The 323 swappable assets: { chainId, updated, assets: [{ address, native, symbol, name, decimals, logoURI, priceUsd, poolDepthBtcw }] }. Native BTCw has address = 0xEeee…EEeE and native: true.

Quote + prebuilt transaction. Full guide and example response: Wallet swap integration.

Status codes: 200 quote returned · 400 invalid input ({ error }) · 422 no route can fill the order (routes[].error still included) · 502 RPC read error.

Chain-wide figures used by the Dashboard: block, validators, btcw_usd, tvl_usd (split into tvl_clp_usd / tvl_oracleamm_usd), volume_24h, swaps_24h, fees_24h_usd, total_swaps, wallets, oracle_assets_fresh (e.g. "100/100"), network, status (per-component health), treasury_addresses.

Volume includes of_which_treasury… fields — the share traded by the Treasury wallets (treasury_addresses) to keep pool prices close to the oracle.

Hourly series, hours up to 720. Each entry: t (start of hour), volClp, volAmm, volTreasury, swaps, swapsTreasury, fees (USD).

Latest swaps (limit up to 300) and the 10 largest swaps in 24 hours: { latest, top24h }. Each swap: venue, from, to, amountIn, amountOut, usd, fee, trader, treasury (bool), block, tx, ts.

The 321 UsdClpPools pools (USDw hub, R-61). Same fields as /api/v2/pools, with depthUsd in place of depthBtcw, plus hub ("USDw") and contract (the UsdClpPools address). A token has one row here and one in /api/v2/pools: tell them apart by contract, not by token address.

Swaps on UsdClpPools, in the same shape as /api/v2/swaps (venue is "usdclp"), plus contract.

One row per asset, merging its BTCw-hub and USDw-hub pools — the data behind btcw.tech/market. Sorted by price, high to low.

• priceUsd, change1hPct, change24hPct — PriceHub oracle; change is null when no sample about 1 h / 24 h old exists.
• depthUsd { btcwHub, usdwHub, total } and depthTokens — what both pools hold.
• user { trades, buys, sells, volumeUsd } — trades by wallets outside the Treasury list (treasury_addresses in /api/v2/stats) in the window. A buy is BTCw or USDw in, the asset out.
• keeper { trades, volumeUsd } — Treasury keeper wallets; never included in user.
• reference — see below; null when the asset has no listed market or the data is older than 5 minutes.
• totals — sums of user and keeper; totals.user.volumeUsd (24h) equals volume_24h.total_usd − of_which_treasury_usd in /api/v2/stats.

Market data of the same asset elsewhere, with its source — one primary market per asset: Binance spot (<BASE>USDT), Binance USD-M futures, or a Hyperliquid perpetual (HIP-3 dex for stocks and ETFs). Refreshed every 30 s; values older than 5 minutes are not served. Without asset it returns every asset.

{ "symbol": "NVDAw", "class": "stock",
  "reference": { "source": "hyperliquid", "market": "xyz:NVDA", "volume24hUsd": 52276848.48, "change24hPct": 1.77,
                 "high24h": null, "low24h": null, "lastPrice": 239.45, "updatedAt": 1791262289 },
  "onchain": { "volume24hUsd": 32739799.67, "userVolume24hUsd": 0, "trades24h": 40, "userTrades24h": 0 } }

Show reference.volume24hUsd with its source (for example "Vol 24h · Hyperliquid"); it is not trading on chain 482120 — that is onchain.

Price API: { ok, block, age_seconds }.

Indexer: { ok, lastBlock, builtAgoS }. Returns 503 until indexing has finished (after a restart) — as do all other /api/v2/* endpoints.