THORChain Swap

The official web interface for native cross-chain swaps, powered by THORChain and Maya Protocol — live at swap.thorchain.org.

Trade Bitcoin, Ethereum, stablecoins, and other layer-1 assets directly between chains: no bridges, no wrapped tokens, no order books, and no user accounts. Users connect their own wallet and sign transactions locally, or swap without connecting a wallet at all via memoless ("instant") swaps.

THORChain Developer Resources

THORChain developer resources for the swap interface — API docs, OpenAPI spec, auth docs, and MCP server:

• Developer portal — the index (Markdown: /developers.md)
• Quickstart — first swap quote in one request, no API key
• REST API reference — endpoints, error format, idempotency, versioning, sandbox
• MCP server reference — tools, parameter schemas, MCP Apps, rate limits
• Authentication — none needed here; where aggregator API keys come from
• SDKs — @tcswap/sdk for building swaps, plus Python (sdk/python) and Go (sdk/go) clients for the keyless public surfaces
• Webhooks and event polling — how to track swap state without webhooks
• OpenAPI 3.1 description — the public REST API
• MCP server — public Model Context Protocol server at /mcp with swap-quote, pool, and network tools (supports MCP Apps)
• Authentication model — anonymous, rate-limited public access; no key, token, or OAuth for the MCP server, and free aggregator API keys via the affiliate program

AI Agent Resources

• llms.txt — index of agent resources with when-to-use guidance
• Agent library — complete single-file reference (URL scheme, MCP examples, asset notation, quote semantics, safety rules)
• AGENTS.md — guidance and safety rules for agents using the site
• AGENTS.md (repo root) — instructions for AI coding agents working on this codebase

Development

npm install
npm run dev

Open http://localhost:3000. Copy .env.example to .env and fill in the API keys. Typecheck with npx tsc --noEmit -p tsconfig.json.

See AGENTS.md for architecture notes, key paths, and conventions.