Docs
Build on SwapsPro.
SwapsPro is a non-custodial swap terminal and wallet toolkit. Everything it does in the browser is also available to you: a headless TypeScript SDK, a CORS-open HTTP API with no key, an embeddable widget, and treasury tooling that runs inside a Safe.
SDK
@swapspro/sdk — quote and execute swaps from your own UI through any EIP-1193 wallet. Zero runtime dependencies, non-custodial, fully typed.
HTTP API5 PAGES
The five public SwapsPro endpoints — chains, tokens and quote — with every parameter, a real response body, the error codes, CORS and the rate limit.
GET /chains · GET /tokens · GET /prices · GET /quote · GET /access
AI agents
The whole path for an autonomous agent: discover chains and tokens, quote, branch on the three execution shapes, sign, broadcast, track — and the x402 handshake.
Widget
Put the SwapsPro swap card on your own site in an iframe: the snippet, every query parameter, the deep theme object it takes by postMessage, auto-height, and where the SDK starts.
DAO & treasury
Run SwapsPro from a Safe: add it as a Safe App, sign orders with ERC-1271, pay a team with Batch Send, ladder a treasury sale with TWAP, and deploy Splits.
Tools9 PAGES
The tools SwapsPro ships beside the swap card — one page each, covering what every one of them signs, what it costs, and what it refuses to do.
Batch Send · CSV Airdrop · Launch a token · Batch Swap + Burn · Limit orders · Danger Zone · Create Contract · Partners · Pro Pass
Free & Pro
What every visitor gets for free, what the Pro Pass adds, and — marked as such — what is planned rather than built. Capabilities, not marketing.
Fees
Every path through SwapsPro and what it costs, in one table: swap routing fees, the flat Batch Send fee, partner fees, and the paths that charge nothing.
Which one do I want?#
The three integration surfaces differ in how much of the experience you own. Pick the least work that gets you what you need.
| Surface | You build | Best for |
|---|---|---|
| Widget | Nothing — you paste an iframe | A site that wants a working swap on a page today, in its own colours. |
| SDK | Your own UI; we quote and hand you a transaction | A product with its own design system, a game shop, a bot. |
| HTTP API | Everything, in any language | Non-JavaScript runtimes, servers, engines, agents. |
The widget and the SDK both sit on the same HTTP API, so the routing, the chains and the fees are identical whichever one you pick. If the thing doing the integrating is an autonomous agent rather than a person, AI agents walks the whole path end to end — discover, quote, sign, broadcast — and covers the parts an agent has to get right that a UI hides.
Sixty seconds#
No key, no account, no signup. These three requests are the whole quoting surface, and they work from a terminal right now:
quickstart
# 1. What can SwapsPro price?
curl "https://www.swaps.pro/api/sdk/v1/chains"
# 2. What can it price on Base?
curl "https://www.swaps.pro/api/sdk/v1/tokens?chainId=8453"
# 3. Quote 0.1 ETH into USDC on Base, ready to sign.
curl "https://www.swaps.pro/api/sdk/v1/quote?sellChain=8453&sellToken=ETH&buyChain=8453&buyToken=USDC&amount=0.1&address=0xYourAddress"A same-chain EVM quote comes back with a ready-to-sign tx (and an approval when you are selling an ERC-20). A cross-chain route like BTC → ETH comes back with a depositAddress and a memo instead. Either way you sign it — SwapsPro never holds keys or funds.
What is non-custodial actually doing here#
- Quotes are data. The API returns transaction fields; your wallet signs them. There is no SwapsPro account, no deposit, no balance held anywhere.
- Where a route carries a SwapsPro fee, it is stamped server-side into the quote. An integrator can neither strip it nor redirect it — and not every route carries one, which the fee table spells out per venue.
- Nothing is stored about you. There is no database of integrators, sessions or users — partner attribution is a request log, which is exactly as much as it sounds like.
Status
@swapspro/sdk is on npm at 0.1.1. @swapspro/widget, the React wrapper around the embed, is not published yet — build it from packages/widget or drop the iframe in directly. The HTTP API both of them wrap is live and public today.For DAOs and treasuries#
SwapsPro runs as a Safe App. A multisig can swap, place gasless limit orders that its owners sign with ERC-1271, pay a whole team in one batched transaction, ladder a treasury sale over days with TWAP, and deploy a Splits contract that shares out every payment it receives. That is its own page — DAO and treasury tooling — because the mechanics of a contract account are genuinely different from an EOA's, and most of the surprises live there.
The rest of the site#
- About — which chains sign for real and which are still in demo, line by line.
- AI agents — the end-to-end path for a program: the three execution shapes, the exact headers, and the x402 handshake for raising your rate limit.
- llms.txt — the same facts as a short index a language model can read, and llms-full.txt with the content inlined. Both are generated from these pages, so they cannot contradict them.
- Source — every claim on these pages is traceable to it.