A crypto swap widget is an embeddable exchange component that lets your wallet users swap one coin for another without leaving your app. With a non-custodial swap widget like GhostSwap's, funds pass through and are never held by GhostSwap or by your wallet — the swap is quoted, the user sends, and the destination coin arrives at their address. You add coverage across 1,600+ pairs without maintaining a single exchange relationship yourself.
TL;DR: Wire GhostSwap's swap API into your wallet, render the quote-and-send flow inside your UI, and route users through a no-KYC, non-custodial swap. End users need no account; you need no KYC pipeline. Partner revenue share is available via GhostSwap's partners page.
A non-custodial swap widget is an in-app exchange interface that quotes a rate, collects the user's destination address, and routes the swap through a pass-through provider — so the wallet never touches or holds the funds itself.
What is a non-custodial swap widget?
A non-custodial swap widget is a swap flow embedded inside your wallet app that never takes custody of user funds. The user requests a quote, sends their coin to a deposit address for that specific swap, and receives the output coin at their own address. GhostSwap is non-custodial — funds pass through; they are never held by GhostSwap or by your wallet app.
That matters for wallet builders for three concrete reasons:
- No custody, no custody risk — your app never holds swap balances, so there's no pooled-funds surface to secure.
- No KYC pipeline — GhostSwap requires no account, no email, and no identity verification for end users, so you carry no verification overhead for the swap itself.
- Full coin coverage from one integration — GhostSwap supports 1,600+ pairs across roughly 200 assets, spanning BTC, ETH, XMR, SOL, and altcoin networks. You offer that range without negotiating one exchange relationship per coin.
Pricing is floating-rate from aggregated liquidity — the user gets the rate at the moment their funds arrive, within the quoted spread, rather than a fixed rate that can fail on slippage.
Step-by-step: integrate GhostSwap's swap API into your wallet
At a high level, a wallet integration follows the same five steps regardless of platform. Read the current endpoint reference in the GhostSwap API documentation before you build — the docs are the source of truth for parameters, rate limits, and response shapes.
- Get API access. Request partner API credentials through GhostSwap's partners channel. This also enrolls you for revenue share (see below).
- Fetch a quote. Call the estimate endpoint with the input coin, output coin, and amount. You get back an expected output amount at the current floating rate. Show this in your widget UI so the user sees what they'll receive.
- Create the swap. Submit the input/output pair and the user's destination address. The API returns a deposit address for that swap and an order ID to track it.
- Prompt the user to send. Your wallet already holds the user's input coin, so trigger your normal send flow to the returned deposit address. Funds pass through non-custodially from there.
- Poll status until complete. Track the order ID until the output coin lands at the user's address. Median swap completion time is ~8 minutes, varying with chain congestion (p95 nearer 30 minutes on congested networks).
Because the user supplies their own receiving address and (where relevant) a refund address, the whole flow runs without an account. Test the round trip on a small amount first — for example, a live ETH to XMR swap — before you ship the widget to production.
GhostSwap vs other no-KYC swap APIs for wallet integrations
When you evaluate a swap provider for a wallet, the variables that matter are custody model, KYC requirement for end users, coin coverage, and rate type. Here's how GhostSwap compares against two other no-KYC providers with public affiliate/integration programs.
| Feature | GhostSwap | Exolix | SideShift |
|---|---|---|---|
| End-user account / KYC | None required | None required | None required |
| Custody | Non-custodial pass-through | Non-custodial | Non-custodial |
| Coin coverage | 1,600+ pairs (~200 assets) | See provider site | See provider site |
| Rate type | Floating-rate | Fixed + floating | Fixed + floating |
| Partner revenue share | Yes — via partners channel | See provider site | See provider site |
Figures for Exolix and SideShift are not restated here because they change; check each provider's own documentation for current coverage and terms before you decide. For GhostSwap, the 1,600+ pair count and non-custodial model come from the live product.
Revenue share: how wallet partners earn from swaps
Wallet partners can earn a share of the swap spread on volume they route to GhostSwap. Because pricing is floating-rate from aggregated liquidity, the partner share is drawn from the swap economics rather than added as a separate fee your users see line-itemed.
Specific partner rates depend on volume and integration type, so they're negotiated directly rather than published as a single number. Request current terms through the GhostSwap partners channel when you provision API access. Set up the two together: one onboarding step gets you both API credentials and the revenue-share arrangement.
The practical upside for a wallet: you add a swap feature your users already want, carry no custody and no KYC overhead for it, and turn swap volume into a revenue line instead of a support cost.
Common integration pitfalls and how to avoid them
- Hardcoding a rate. Floating-rate means the price is set when funds arrive, not when the user taps swap. Always show the estimate as an estimate and re-quote if the user lingers.
- Skipping the refund address. For chains that support it, collect a refund address so a failed or below-minimum deposit can be returned. Don't assume the deposit always clears.
- Not polling to completion. Show live status from your order ID until the output lands. Median is ~8 minutes but chain congestion pushes the tail longer — set user expectations accordingly.
- Under-testing minimums. Each pair has a minimum. Test small live swaps across your top pairs before launch.
FAQ
Q: Do my users need an account or KYC to use the swap widget?
A: No. GhostSwap requires no account, no email, and no identity verification for swaps. Your users supply a receiving address and, where relevant, a refund address — that's it.
Q: Does GhostSwap or my wallet hold the funds during a swap?
A: No. GhostSwap is non-custodial — funds pass through and are never held by GhostSwap. Your wallet only sends the user's input coin to the swap's deposit address; the output coin lands at the user's own address.
Q: How many coins can I offer through one integration?
A: GhostSwap supports 1,600+ pairs across roughly 200 assets, including BTC, ETH, XMR, and SOL. One API integration gives your wallet that coverage without per-coin exchange deals.
Q: How long does a swap take?
A: Median swap completion time is about 8 minutes, varying with chain congestion. On congested networks the tail runs longer (p95 nearer 30 minutes), so poll the order status and surface it to the user.
Q: How does partner revenue share work?
A: Wallet partners can earn a share of swap volume they route. Rates depend on volume and integration type and are arranged when you provision API access — contact the GhostSwap partners channel for current terms.
Start building
If you're adding swaps to a wallet, start from the GhostSwap API documentation, then test the flow with a live pair like BTC to XMR or run a quote through the swap widget on the homepage to see the quote-and-send flow end to end.
