# PulseSwap

> PulseSwap is a non-custodial DEX aggregator — the aggregator of aggregators: it quotes DEXes and aggregators on 17 blockchains at the same moment and routes each trade through whichever one pays out the most.

Swaps settle straight from the user's wallet: no account, no signup, no email, and no custody of funds at any point. On PulseChain a quote is built across 11 DEXes & aggregators (PulseX V1/V2/Stable, 9inch v2/v3, 9mm v2/v3, Phux.io, 0xTide, Piteas and the PulseSwap router); on the other supported chains quotes come from aggregator partners.

Every documentation page below is available as clean Markdown — the links in the Documentation and Learn sections point straight at those mirrors, and each mirror ends with a link back to its HTML page. An article's mirror is its own URL plus `.md`; the hub's is `/docs/index.md`, because `/docs` is the directory those mirrors live in.

## App

- [Swap](https://pulseswap.io/): The swap itself — pick a pair, compare every route side by side, and trade from your own wallet. Deep links accept `?chain=`, `from=`, `to=` and `amount=` (plus `embed=` and `border=` for the iframe widget).
- [Stats](https://pulseswap.io/stats): A screenshot-ready price board — your watchlist or any shared set of PulseChain tokens, refreshed every minute, with price alerts.
- [Tokens](https://pulseswap.io/tokens): Every PulseChain token with live price, 24h and 7d change, volume and liquidity, each row linking straight into a swap.

## Documentation

- [Documentation hub](https://pulseswap.io/docs/index.md): Index of the seven guides — what PulseSwap is, the quickstart, embedding the widget, the API, the SDK, the guide for bots and AI agents, and the coverage table.
- [What is PulseSwap](https://pulseswap.io/docs/what-is-pulseswap.md): How best-rate routing across DEXes & aggregators works, and why the swap is non-custodial. Includes the published FAQ.
- [Quickstart](https://pulseswap.io/docs/quickstart.md): The three ways in — swap on the site, embed the widget in one iframe, or call the quote API from your own app.
- [Embed the widget](https://pulseswap.io/docs/embed-swap-widget.md): Put the swap card on your own site with one iframe; every URL parameter (`embed`, `chain`, `from`, `to`, `amount`, `border`) documented against the live app.
- [API reference](https://pulseswap.io/docs/api.md): The quote API at `https://quotes.pulseswap.io/api/v2` — `POST /quotes` and `POST /quotes/advanced`, request and response schemas, platforms, validation, errors, rate limits.
- [SDK reference](https://pulseswap.io/docs/sdk.md): `pulseswap-sdk` for TypeScript — installation, `getQuote`, the `Platform` and `QuoteMode` enums, and every type it returns.
- [For bots & AI agents](https://pulseswap.io/docs/agents.md): The integrator page for a caller with no browser — one keyless `POST /quotes/advanced` with `"platform": "mixed"` returns the best PulseChain route plus the transaction data your own signer sends, with a curl example, a viem bot flow, the single-DEX platform identifiers, rate limits and the etiquette we ask of automated callers. PulseChain (chain 369) only.
- [Supported chains & DEXes](https://pulseswap.io/docs/supported-chains.md): Every chain PulseSwap routes on and the quote sources behind each one, generated from the live routing config rather than written by hand.

## Legal

- [Privacy policy](https://pulseswap.io/docs/privacy.md): What PulseSwap does and does not collect. No accounts, no personal information and no identity checks; the anonymous operational records the interface does keep are keyed to public wallet addresses, and the page names what is sent to third-party quote sources, RPC providers and data services.
- [Terms of service](https://pulseswap.io/docs/terms.md): The agreement for using the interface: non-custodial trading where keys and funds are never held, eligibility, permissionless token access with no endorsement, third-party services, disclaimers, and limitation of liability.

## Learn

Editorial articles about market mechanics, sourced to primary references (SEC releases, ESMA, academic preprints, DefiLlama) and cited inline, plus tool pages whose values are generated from the app's own configuration. Same Markdown-mirror convention as the documentation above.

- [Learn hub](https://pulseswap.io/learn/index.md): Index of the six guides, grouped into the PulseChain how-tos (swap, bridge, add the network) and the essays on how aggregation works (what a DEX aggregator is, aggregator of aggregators, smart order routing). The hub's mirror is `/learn/index.md`, because `/learn` is the directory those mirrors live in.
- [What is a DEX aggregator](https://pulseswap.io/learn/what-is-a-dex-aggregator.md): The definition and the mechanism: how one trade is quoted across many exchanges at once, why a quote is a price for one size rather than a rate, how routes are ranked after gas, what separates a DEX from an aggregator, and what measured research (a 2026 audit of 2.98 million Ethereum swaps, a 2025 study of solver-based exchanges) says about the prices aggregators actually get.
- [Aggregator of aggregators](https://pulseswap.io/learn/aggregator-of-aggregators.md): The approach PulseSwap takes, written out with its arithmetic and its limits: why comparing other aggregators' answers alongside directly priced pools cannot do worse than comparing a subset, the conditions that make that true (same request, same moment, ranked after gas, only over the sources that answered), what the fan-out looks like on PulseChain, and the three things it does not do.
- [Smart order routing](https://pulseswap.io/learn/smart-order-routing.md): What a smart order router does, why US and EU equity markets built one first under Reg NMS and MiFID best execution, how DEX aggregators re-derived it without a regulator, and what to check on a quote before taking it.
- [How to swap on PulseChain](https://pulseswap.io/learn/how-to-swap-on-pulsechain.md): The swap itself, step by step against the shipped app: what you need before the first trade, the six steps from picking a chain to signing, how the route list is ordered and re-quoted, what the slippage panel offers, what gas costs, and the errors that actually come up.
- [How to bridge to PulseChain](https://pulseswap.io/learn/bridge-to-pulsechain.md): The two different bridges that reach PulseChain, kept apart: the USDC bridge inside the swap app, which moves USDC over Hyperlane warp routes and credits hUSDC on arrival, and the official PulseChain bridge at bridge.pulsechain.com, which is the Ethereum route and carries ether itself. Steps for the first, what each costs, and what to check when a transfer will not go through.
- [Add PulseChain to MetaMask](https://pulseswap.io/learn/add-pulsechain-to-metamask.md): The PulseChain network details for any EVM wallet, read out of PulseSwap's own chain configuration: network name `PulseChain`, RPC URL `https://rpc.pulsechain.com`, chain ID `369` (`0x171`), currency symbol `PLS`, and the block explorer, plus the manual MetaMask steps and the four errors that actually come up.