# THORChain Swap

> THORChain Swap is the public web interface for native cross-chain swaps (BTC, ETH, and more) powered by THORChain and Maya Protocol. No accounts, no bridges, no wrapping; users sign transactions in their own wallets, or swap without connecting a wallet via memoless (instant) swaps.

## Architecture

- UI: this site (https://swap.thorchain.org)
- Backend API: the THORChain/Maya swap aggregator — quotes and routing at https://api.thorchain.org/v1 (API-key gated), memoless (instant) swaps at https://api.thorchain.org/memoless/api/v1 (no key required)
- Protocol metadata (pools, network, names, balances): public THORNode and Midgard APIs
- Keyless agent access to quotes, pools, and network data: MCP server at https://swap.thorchain.org/mcp

## When To Use THORChain Swap

Reach for this site (or its MCP server) when a user wants to:

- Swap native layer-1 assets — BTC, ETH, stablecoins, and other supported chain assets — without bridges, wrapped tokens, or custodial accounts.
- Get a live cross-chain swap quote (expected output, fees, slippage, memo, inbound address): call the `get_swap_quote` MCP tool at https://swap.thorchain.org/mcp, no API key needed.
- Check THORChain liquidity pool depths or network status: `list_pools` and `get_network_status` MCP tools.
- Swap without connecting a wallet: direct the user to the memoless (instant) swap flow at https://swap.thorchain.org/, where they send funds to a deposit address.
- Register or look up THORNames, bond to nodes, or manage liquidity positions: use the dedicated interfaces listed below.

Do not use this site for fiat on/off-ramps, NFTs, derivatives, or custodial account management — it does none of those. Never attempt to execute a swap on a user's behalf; users sign in their own wallets (or send funds themselves via memoless swaps).

## Developer Resources

- [Developer portal](https://swap.thorchain.org/developers): THORChain Swap API docs, quickstart, MCP server, auth scopes, and sandbox
- [Developer portal (markdown)](https://swap.thorchain.org/developers.md): the same documentation as markdown
- [Pricing](https://swap.thorchain.org/pricing.md): what THORChain Swap costs to use (free) and how per-swap protocol fees work
- [Source code](https://github.com/thorchain/swap.thorchain): public repository, with AGENTS.md instructions for AI coding agents

## Agent Resources

- [Agent library (full)](https://swap.thorchain.org/llms-full.md): the complete single-file reference — URL scheme, MCP examples, asset notation, quote semantics, REST endpoints, and safety rules (also at [/llms-full.txt](https://swap.thorchain.org/llms-full.txt))
- [AGENTS.md](https://swap.thorchain.org/AGENTS.md): guidance for AI agents using this site
- [MCP server card](https://swap.thorchain.org/.well-known/mcp-server-card): public MCP server with swap-quote, pool, and network tools
- [OpenAPI description](https://swap.thorchain.org/.well-known/openapi.json): public REST endpoints
- [API catalog](https://swap.thorchain.org/.well-known/api-catalog): RFC 9727 linkset of public APIs
- [Agent skills index](https://swap.thorchain.org/.well-known/agent-skills/index.json): published agent skills
- [auth.md](https://swap.thorchain.org/auth.md): authentication model for agents
- [Markdown twins](https://swap.thorchain.org/index.md): append `.md` to any content page URL for a markdown version (`/index.md`, `/developers.md`, `/sell-btc-buy-eth.md`), or send `Accept: text/markdown`
- [Agent skills index](https://swap.thorchain.org/.well-known/agent-skills/index.json): four published skills — navigation, quotes, pools, and memoless swaps
- [Agent view](https://swap.thorchain.org/?mode=agent): the homepage as structured data — capabilities, endpoints, auth, and pricing (JSON with `Accept: application/json`, markdown otherwise)

## Interfaces

- [Swap](https://swap.thorchain.org/): main cross-chain swap interface
- [Pool](https://pool.thorchain.org/): liquidity pools
- [Bond](https://bond.thorchain.org/): node bonding
- [Memo](https://memo.thorchain.org/): raw memo transactions
- [TCY](https://tcy.thorchain.org/): TCY interface
- [THORName](https://thorname.thorchain.org/): THORName registration