THORChain Swap
Read-only THORChain swap quotes, liquidity pools, and network status.
Open source Repository Open in the app JSON README (API)
About
Read-only THORChain swap quotes, liquidity pools, and network status.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- org.thorchain.swap
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 0.4.1
- Stars
- 1
- Forks
- 1
- Last push
- 2026-09-03T09:26:28Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-29 04:01:53
- Updated
- 2026-08-29 04:01:53
- Origin id
org.thorchain.swap/thorchain-swap
README
# THORChain Swap
The official web interface for native cross-chain swaps, powered by [THORChain](https://www.thorchain.org) and Maya Protocol — live at
[swap.thorchain.org](https://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](https://swap.thorchain.org/developers) — the index (Markdown: [/developers.md](https://swap.thorchain.org/developers.md))
- [Quickstart](https://swap.thorchain.org/developers/quickstart) — first swap quote in one request, no API key
- [REST API reference](https://swap.thorchain.org/developers/api) — endpoints, error format, idempotency, versioning, sandbox
- [MCP server reference](https://swap.thorchain.org/developers/mcp) — tools, parameter schemas, MCP Apps, rate limits
- [Authentication](https://swap.thorchain.org/developers/auth) — none needed here; where aggregator API keys come from
- [SDKs](https://swap.thorchain.org/developers/sdks) — [`@tcswap/sdk`](https://www.npmjs.com/package/@tcswap/sdk) for building swaps, plus Python
([`sdk/python`](./sdk/python)) and Go ([`sdk/go`](./sdk/go)) clients for the keyless public surfaces
- [Webhooks and event polling](https://swap.thorchain.org/developers/webhooks) — how to track swap state without webhooks
- [OpenAPI 3.1 description](https://swap.thorchain.org/.well-known/openapi.json) — the public REST API
- [MCP server](https://swap.thorchain.org/.well-known/mcp/server-card.json) — public Model Context Protocol server at `/mcp` with swap-quote, pool,
and network tools (supports MCP Apps)
- [Authentication model](https://swap.thorchain.org/auth.md) — anonymous, rate-limited public access; no key, token, or OAuth for the MCP server, and
free aggregator API keys via the [affiliate program](https://affiliate.thorchain.org)
## AI Agent Resources
- [llms.txt](https://swap.thorchain.org/llms.txt) — index of agent resources with when-to-use guidance
- [Agent library](https://swap.thorchain.org/llms-full.md) — complete single-file reference (URL scheme, MCP examples, asset notation, quote
semantics, safety rules)
- [AGENTS.md](https://swap.thorchain.org/AGENTS.md) — guidance and safety rules for agents using the site
- [`AGENTS.md`](./AGENTS.md) (repo root) — instructions for AI coding agents working on this codebase
## Development
```bash
npm install
npm run dev
```
Open [http://localhost:3000](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`](./AGENTS.md) for architecture notes, key paths, and conventions.