Assets — Bitcoin Swap Developers

Concepts › Assets

Get started

Overview Quickstart Network Contract addresses

Concepts

Assets Swap mechanics Price oracle Bridge Trust model

Guides

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 Changelog Security

The chain has 202 tradable assets. All of them use 18 decimals.

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)

200 tokens in two classes. 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 or stable (USDw).

Class	Count	Examples	Tracks
Crypto	100	ETHw, SOLw, BNBw	top 100 tokens by market cap
US stocks	100	NVDAw, AAPLw, MSFTw	the share price of the 100 largest US companies by market cap; named `"<Company> Stock Price Tracker"`

Both 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.