Quickstart

Updated August 20263 min readView as Markdown

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.

  1. Open the swap and pick the network.
  2. Choose the token you are selling and the one you are buying, then type an amount.
  3. 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.
  4. 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.

Always pass 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
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.

Piteas is one of the partners PulseSwap routes through, and its quote API is origin-whitelisted. It answers requests from the pulseswap.io origin — so it works on the live site and in your embedded widget, while a curl from your laptop gets a 403 and simply sees one route fewer.

What next

About PulseSwap

Start swapping, or start building

PulseSwap quotes every route at once — PulseX, Piteas, 9inch, 9mm and every major aggregator, across 17 blockchains — then routes your trade through whichever one pays out the most. Use it here, embed it in one iframe, or call the same quotes from your own app.