Assets — Bitcoin Swap Developers

Concepts › Assets

Get started

Overview Quickstart Network Contract addresses

Concepts

Assets Swap mechanics Price oracle Bridge Trust model

Guides

Deploy a contract Read prices Swap through contracts Swaps for wallets Bridge funds Test on a chain fork

Reference

REST API JSON-RPC Limits & errors Contract reference JavaScript SDK

Operations

Status Run a node Changelog Security

The swap API lists 323 assets — native BTCw, USDw and 321 price-tracker tokens — all with 18 decimals (/api/v2/swap/assets). Two bridged tokens trade on the Uniswap V2 pair instead: WBTCw (18 decimals) and USDC.e (6 decimals).

Token list

btcw.tech/tokenlist.json lists every ERC-20 on chain 482120 in the Uniswap Token Lists format (325 tokens, served with CORS), ordered by price. Native BTCw is not in it, because it is not an ERC-20. Tags give the asset tier: bridged (WBTCw, USDC.e), tracker with crypto or equity (the 321 trackers), unit (USDw) and staking (stBTCw). Names longer than 40 characters are shortened in the list; the on-chain names are unchanged. Wallets and aggregators can import the URL directly.

BTCw — native coin

The chain's native coin, used to pay gas and as the shared side of every pool. In the API and SDK, BTCw is represented by the placeholder address 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE (the strings native, BTCw and 0x000…0 are also accepted).

Price = BTC/USD rate from the oracle × OracleAMM's peg ratio ratioWad (currently 1).

USDw

ERC-20 at 0x3b5BD179CA6Aab4DAF0f842829776843ABe6e727. Used as the unit of account in OracleAMM and as the bridge asset.

The Owner can mint USDw (mint is Owner-only).
The bridge moves USDw 1 : 1 against USDC / USD₮0 locked in the Arbitrum routers; withdrawals are capped at the amount locked on that side.
Current total supply: the usdw_total_supply field of /api/price.

Price-tracker tokens (…w)

321 tokens: crypto, US stocks and US ETFs. Each token tracks the USD price of an external asset via the PriceHub oracle and has one pool against BTCw in ClpPools. The class field of /api/v2/pools gives the class: crypto, stock (US stocks and US ETFs) or stable (USDw).

Class	Count	Examples	Tracks
Crypto	100	ETHw, SOLw, BNBw	top 100 tokens by market cap
US stocks	201	NVDAw, AAPLw, MSFTw	the share price of the 100 largest US companies by market cap, plus 101 more large companies from Binance's stock list; named `"<Company> Stock Price Tracker"`
US ETFs	20	VOOw, SPYw, QQQw	the share price of 20 large US-listed ETFs by assets under management; named `"<Fund> ETF Price Tracker"`

All classes run on the same mechanism: the same TokenFactory, PriceHub and ClpPools, and the same OracleRebalancer + keeper keeping pool prices near the oracle.

The tracked price is the regular-session share price, multiplied by a split factor (splitFactor) so the series stays continuous across stock splits.
Tokens are created by TokenFactory; the only minter is OracleRebalancer, within each token's mint cap and a daily mint-value cap (see Swap mechanics).
Full list (address, name, logo, oracle price, pool depth): /api/v2/swap/assets.

Identifying assets

Always match on chainId 482120 + contract address. Do not match on symbol: BTCW, USDW and many …w symbols are already used by unrelated assets on other chains and on price-data platforms.

Symbols are for display only. The quote API still accepts symbols for convenient manual testing, but production integrations must send addresses.

Logos

BTCw logo: https://btcw.tech/logo.svg (a logo.png version is also available). USDw: https://btcw.tech/usdw.png. Price-tracker tokens: the logoURI field in /api/v2/swap/assets.