Plug the universal swap into your product.

The uSwap Partner API is the operator surface for the universal swap engine. Issue persistent deposit addresses to your users, route their deposits across 30+ networks plus gift cards / Telegram / Discord / VPN / prepaid Visa, set your own affiliate fees per quote, and reconcile via signed webhooks. REST + OpenAPI, no SDK required.

What it is

partner.uswap.net is the operator surface for the same engine that powers app.uswap.net. Issue a persistent deposit address per end-user, set your own per-quote affiliate fees, route their deposits across 30+ crypto networks plus the spend side (Telegram, Discord, Mullvad, gift cards, prepaid Visa, P2P fiat), and reconcile via signed webhooks.

The whole surface is REST. Auth is an organization-scoped bearer token. The OpenAPI 3.1 spec lives at /v1/openapi.json and can be used with standard client generators.

REST + OpenAPI 3.1 Bearer auth, scoped keys Idempotency-Key supported Signed webhooks Per-quote affiliate fees Same engine as uSwap.net

What you can build

Integrations can compose supported value inputs and destinations through the same stateful routing and recovery engine.

Crypto checkout for any product

Accept any supported crypto on any chain; settle in your treasury asset. Customers see one address, the engine handles the multi-hop.

"Pay with crypto" for SaaS

Bill your customer in fiat or stablecoin; let them top up in BTC, ETH, USDC, XMR, TON, or whatever they actually hold.

Telegram / Discord spend bots

Bot frontends for supported Telegram Premium / Stars / channel boosts and Discord Nitro / server boosts.

Wallet / exchange integrations

Persistent per-user deposit addresses inside your existing wallet UI. Recovery and refund flows surface as API endpoints.

Crypto in. Fiat out.

Integrate eligible crypto, gift-card, prepaid, or fiat destinations. The standard uSwap crypto interface does not require users to create an account or submit identity documents directly to uSwap. Providers and counterparties may apply identity checks, transaction limits, sanctions controls, or geographic restrictions depending on the selected route.

Recovery as a service

Expose the unmatched-deposit / wrong-network / refund flows uSwap uses to your own users instead of routing them to support.

Auth, scopes, idempotency

Auth

Bearer tokens, scoped per key

Authorization: Bearer uswp_org_<prefix>_<secret>. Keys are minted in the dashboard and shown once on create.

Scopes

Least-privilege by default

stats:read, catalog:read, bridges:read, bridges:write, intents:read, intents:write, positions:read, positions:write, webhooks:read, webhooks:write.

Idempotency

Safe retries, built in.

Mutating endpoints accept an organization-scoped Idempotency-Key (max 160 chars, 24-hour retention). Integrations should supply it for safe replay semantics.

Webhooks

HMAC-signed lifecycle events

Intent state transitions (createdmatchedexecutingcompleted / refunded / failed) push to your endpoint with HMAC-SHA256 signatures. Failed deliveries retry over 24 hours and surface in the Deliveries log.

Same engine, two product shapes

Whether your users hit uSwap directly or via your integration, the engine underneath is identical.

SurfaceuSwap.net (consumer)partner.uswap.net (operator)
Routing engineSameSame
Coverage30+ chains + spend products30+ chains + spend products
Recovery (wrong network / amount)UI buttonsAPI endpoints + webhooks
Deposit addressPersistent per bridgePersistent per (org, end-user)
Locked rate vs market rateUser picksOperator picks at quote time
Affiliate / app fee0% uSwap platform fee on eligible standard crypto routesDisclosed operator-set per-quote bps overlay, subject to terms
ReconciliationNot applicableProvider-reported, dashboard Earnings view
AuthNoneBearer + scoped keys + idempotency
Surface contractWebSocket protocolREST + OpenAPI 3.1 + webhooks

Partner FAQ

Anything that needs to convert one form of value into another. Plug uSwap into a checkout to accept any crypto and settle in your treasury asset. Add 'pay with crypto' to a SaaS that bills in gift cards. Build a Telegram bot that tops up Stars / Premium / channel boosts. Issue persistent deposit addresses per user inside a wallet or exchange UI. The same engine that powers app.uswap.net is exposed as REST.