For the complete documentation index, see llms.txt. This page is also available as Markdown.

What is Swapper?

Swapper is a deposit layer you embed in your app. Drop in one widget and your users can fund your product with any token, from any chain, or with a debit card — and you receive exactly the token you asked for, on the chain you asked for, at the wallet you nominated.

Here is the core idea:

  1. You register as an integrator and decide on a destination: a chain, a token, and a wallet address that should receive funds.

  2. You embed the Swapper widget in your app — as an iframe, a modal, or an inline component.

  3. Your user picks how they want to pay: card, crypto transfer from their wallet, or a one-tap smart-wallet deposit.

  4. Swapper handles the on-ramp, the cross-chain routing, and the swap, then delivers the destination token to your wallet.

  5. You find out it happened — instantly in the browser via widget events, or server-side via webhooks.

Why Swapper?

  • One integration, every funding path. Fiat card payments, same-chain and cross-chain crypto transfers, and account-abstraction deposits all live behind a single widget with four required parameters.

  • You choose what you receive. The user's messy reality — a dozen tokens across a dozen chains — is normalized to the one token and chain your app actually wants. See Core Concepts.

  • Drop-in, framework-agnostic. You embed Swapper through the hosted widget via the iframe SDK — it works in any stack, in any framework or none.

  • Yours to brand. Theme the widget with your colors, radius, and copy so it feels native to your product. See Styling & Theming.

  • Programmable. Chain arbitrary on-chain actions after the swap — stake, wrap, provide liquidity — with Custom Contract Calls.

Who is Swapper for?

  • Integrators & developers — you run an app (a game, an exchange, a prediction market, a DeFi protocol, a wallet) and you want users to fund it without wrestling with bridges, DEXes, and on-ramps. Start with the Quick Start.

  • Product & growth teams — you want the highest-converting funding flow you can ship in an afternoon and measure end to end. Skim How Swapper Works and Tracking Deposits.

Getting an integratorId. Every integration is tied to a registered integrator id, which also links your webhook endpoint. To get one, open a ticket in Discord — see Support.

Where to go next

You want to…
Start here

Understand the model in five minutes

Ship an embed today

Pick the right integration style

Get notified when deposits complete

Last updated