Quickstart
There are three ways to use PulseSwap, and they take about a minute, ten minutes and an afternoon respectively. All three quote the same routes and settle the same way — non-custodial, straight from the user's wallet.
1. Swap on pulseswap.io
No account, no signup, no email. Open the swap, pick a pair, and PulseSwap quotes every DEX & aggregator enabled for that chain at once — 11 of them on PulseChain, across 17 blockchains in total — then routes your trade through whichever one pays out the most.
- Open the swap and pick the network.
- Choose the token you are selling and the one you are buying, then type an amount.
- Compare the routes: every quote stays on screen with what it would pay out, and the best one is selected for you. Take a different one by hand whenever you disagree.
- Connect a wallet and confirm. Quotes are fetched with no wallet attached, so connecting is the last step.
2. Embed the widget on your site
One <iframe> puts the whole swap card on your own page — best-rate quotes, wallet connect and execution, without sending your users anywhere. No key, no registration, no rate limit, and the same rates as pulseswap.io itself.
The URL takes chain, from, to, amount and border, so you can hand a visitor a preselected pair. Embed the widget has the copy-paste snippet, a live demo of the real widget and every parameter.
chain in a deep link. Without it the URL normalizer rewrites the query to its default and your to token is dropped.3. Build against the API or the SDK
For wallets, dApps and trading tools that need the quote itself rather than a UI. The quote service takes a JSON body and answers with the amount out, a gas estimate and — when you pass a user address — ready-to-send transaction data.
Two endpoints, same request and response shape: POST /quotes for the standard routing algorithm, and POST /quotes/advanced for a deeper route search on large or illiquid pairs. Both live under https://quotes.pulseswap.io/api/v2.
curl -X POST https://quotes.pulseswap.io/api/v2/quotes \ -H "Content-Type: application/json" \ -d '{ "chainId": 369, "platform": "pulsex_v2", "fromToken": "0x0000000000000000000000000000000000000000", "toToken": "0x95B303987A60C71504D99Aa1b13B4DA07b0790ab", "amountIn": "1000000000000000000", "slippage": 0.5 }'
That is the whole handshake. API reference documents the request and response schemas, the platforms you can name, the validation rules and the error shapes; if you are writing TypeScript, the SDK reference wraps the same service in a typed client (pulseswap-sdk on npm) that picks the right endpoint for you.
curl from your laptop gets a 403 and simply sees one route fewer.What next
- What is PulseSwap — how best-rate routing and custody actually work.
- Supported chains & DEXes — every network and every quote source, generated from the live routing config.
- API reference and SDK reference — the developer surface in full.
