# Maxy

> Maxy puts native Bitcoin to work on other chains without wrapping, bridging or custodians. Swaps: native BTC to and from tokens on EVM chains and Solana. Loans (MaxyLock): borrow against Bitcoin locked on the Bitcoin network. Mints (Maxy Mint): BTC.R on Robinhood Chain, minted against a Bitcoin payment proven on chain.

Every page is at https://maxy.co/docs/<slug> and has a Markdown twin at the same address plus ".md". The complete text: https://maxy.co/llms-full.txt

## Start

- [What Maxy is](https://maxy.co/docs/what-maxy-is.md): Maxy swaps native Bitcoin with coins on Base, Arbitrum, BNB Chain, Avalanche, Robinhood Chain and Solana, through an HTTP API and a TypeScript SDK. It also…
- [How a swap works](https://maxy.co/docs/how-a-swap-works.md): What happens to the coins when a user buys BTC with ETH on Base. Every other route reuses this flow. Terms are in the glossary.
- [First order](https://maxy.co/docs/first-order.md): Run one order from nothing to completed, with a throwaway wallet that holds nothing. It takes three commands and about a minute, needs no sign-up and no…

## Swaps

- [Buy BTC](https://maxy.co/docs/buy-btc.md): The whole buy with raw calls, from a price to the BTC arriving. Run these samples in order, in one shell or one file, and with a test key they run as they…
- [Other coins](https://maxy.co/docs/other-coins.md): The same order with a different coin. USDC signs without gas, SOL pays from a Solana wallet, and coin to coin moves between EVM chains with no Bitcoin. The…
- [Sell BTC](https://maxy.co/docs/sell-btc.md): Sell BTC for a coin on an EVM chain. The solver locks the payout in the settler before the user sends any BTC. The user pays one Bitcoin output, and a…
- [When it fails](https://maxy.co/docs/when-it-fails.md): Where the money is when an order goes wrong, and who acts next. Every exit but a proven BTC payment sends a buyer's coins back, and no Maxy server can…

## Orders

- [Order states and records](https://maxy.co/docs/order-states-and-records.md): Every route reports one state, from nine values. Branch on state; rawStatus is for support. Then match what happened against your own books.
- [Webhooks](https://maxy.co/docs/webhooks.md): Webhooks tell your server when an order changes, so your records stay right when no user is watching. Maxy sends one signed order.updated event for each…

## Launch

- [Sandbox](https://maxy.co/docs/sandbox.md): The sandbox is the same API with nothing real behind it. To use it, change the key, in the API, the SDK and the CLI. The base URL, routes and JSON stay the…
- [Keys and limits](https://maxy.co/docs/keys-and-limits.md): Which key goes where, how often you can call, and how large an order can be.
- [Launch checklist](https://maxy.co/docs/launch-checklist.md): Tick every box before you go live with your first real user.

## Product and safety

- [Signature screen](https://maxy.co/docs/signature-screen.md): Words for your screens, ready to copy, so users know what they are signing and where their coins are.
- [Security and compliance](https://maxy.co/docs/security-and-compliance.md): What protects the user's coins, what Maxy can and cannot do, and what stays with you.
- [Contracts](https://maxy.co/docs/contracts.md): Check every contract an order touches. The SDK compiles these in, and a server response never picks the contract a user signs for.

## Loans (MaxyLock)

- [How MaxyLock works](https://maxy.co/docs/how-maxylock-works.md): MaxyLock lends against Bitcoin that never leaves the Bitcoin network. The borrower locks BTC in scripts and receives the loan on EVM and SVM chains.…
- [Repaying and defaults](https://maxy.co/docs/repaying-and-defaults.md): How a repayment gets the Bitcoin back, and what each side loses when a party misses its part.
- [Borrow with the SDK](https://maxy.co/docs/borrow-with-the-sdk.md): Take a loan in code: sign in, quote, sign the terms, fund, repay. The SDK rebuilds and checks every term before the wallet signs.
- [Wallets and lenders](https://maxy.co/docs/wallets-and-lenders.md): For teams that run the loan themselves, without the SDK: a wallet taking a borrower through it, and a lender serving it.
- [Loan contracts](https://maxy.co/docs/loan-contracts.md): The contracts behind a loan, and what each promise rests on. Live on Base (chain 8453) and Robinhood Chain (chain 4663), with collateral on Bitcoin…

## Mints (Maxy Mint)

- [How Maxy Mint works](https://maxy.co/docs/how-maxy-mint-works.md): Maxy Mint issues BTC.R on Robinhood Chain, a token whose every unit is matched by Bitcoin the issuer holds. A mint needs a Bitcoin payment proven on chain.
- [Mint with the SDK](https://maxy.co/docs/mint-with-the-sdk.md): Mint BTC.R in code: order, register, pay, track. Minting needs no Maxy sign-in: every action is authorized by a wallet signature.
- [Mint contracts](https://maxy.co/docs/mint-contracts.md): The contracts behind a mint, on Robinhood Chain, chain 4663, and what you rely on the issuer for. The SDK compiles these in.

## SDK

- [Install and signers](https://maxy.co/docs/install-and-signers.md): Set up the TypeScript SDK. It is @maxy-labs/sdk, under the MIT licence, installed from maxy.co rather than the npm registry; it is ESM only and runs on…
- [Command line](https://maxy.co/docs/command-line.md): Try Maxy from a terminal. npx maxy asks whether you want a menu or a command line. Each command also runs once from your shell, with --json for scripts.…
- [Flow helpers](https://maxy.co/docs/flow-helpers.md): One call runs a whole order: quote, checks, signatures, order, escrow if the route has one, then watching to the end. Use these unless you need your own…
- [React and Python](https://maxy.co/docs/react-and-python.md): Use Maxy from a React app or from Python. React ships in your partner kit (npm install ./maxy-react-.tgz); Python installs from maxy.co, MIT licence: pip…

## Reference

- [API routes](https://maxy.co/docs/api-routes.md): Every route of the HTTP API. Each takes your key as x-maxy-key, apart from the index, the spec, /health, the status page and POST /sandbox/keys, which…
- [API reference](https://maxy.co/docs/api-reference.md): The routes an integration uses, each with its parameters, a sample in curl, TypeScript and Python, and a real sandbox answer. The samples use BASE and…
- [Error codes](https://maxy.co/docs/error-codes.md): Look up any error. Every error from the HTTP API is { "error": { "code", "message", "details"?, "retryable", "docs" }, "requestId" }, with the same id in…
- [Chains and tokens](https://maxy.co/docs/chains-and-tokens.md): What Maxy swaps. GET /pairs is always the current list.
- [Glossary](https://maxy.co/docs/glossary.md): The words these pages use, in plain terms.
- [Changelog](https://maxy.co/docs/changelog.md): What changed in the latest release (12 November 2026). Every release: changelog.md, or the RSS feed.

## Optional

- [Full integration guide (PDF)](https://maxy.co/guides/maxy-integration-guide.pdf)
- [The complete text in one file](https://maxy.co/llms-full.txt)
- [MaxyLock documentation (PDF)](https://maxy.co/docs/_media/maxylock-guide/maxylock-documentation.pdf)
- [Maxy Mint documentation (PDF)](https://maxy.co/docs/_media/mint-guide/maxy-mint-documentation.pdf)
- [Changelog feed](https://maxy.co/docs/changelog.xml)
