Bitcoin Swap Get started › Overview
Bitcoin Swap is an EVM chain (Hyperledger Besu, QBFT consensus, chain ID 482120) with three things you can integrate:
prices from the on-chain oracle, swaps across 201 pools (100 crypto tokens, 100 US stocks, USDw) and OracleAMM, and a Hyperlane bridge to Arbitrum One.
Every contract is verified on the explorer, and every public API works without a key.
Live status
Read directly from the chain and the API when you open this page. More detail on Status.
What do you want to build?
/api/price, or read the Chainlink-compatible feed on-chain.
Let your wallet users swapCall one quote endpoint and get back a ready-to-sign transaction.
Swap from a bot or contractCall ClpPools / OracleAMM directly — no server in between.
Move funds between Arbitrum and 482120USDC / USD₮0 ⇄ USDw 1 : 1 over a Hyperlane warp route.
Machine-readable resources
| Resource | Use |
|---|---|
/developers/contracts.json | addresses + ABIs of every public contract, on both chains |
/chain.json | network info in ethereum-lists format |
/api/v2/swap/assets | list of 202 assets: address, symbol, logo, oracle price |
/swap/sdk/btcw-swap.js | JavaScript SDK (ES module, no dependencies) |
/developers/search.json | full-text index of these docs |
How these docs are organized
Concepts explain how the system works; Guides walk through one specific task step by step; Reference lists every endpoint, function and error code. If you only have five minutes, read the Quickstart. Before shipping anything to real users, read Trust model & risks.
There is no separate testnet. To experiment without spending real funds, run a chain fork locally — see Test on a chain fork.