Business API

The Business API is the cleanest choice when you want a classic partner API with server-to-server authentication, strong replay protection, and webhook subscriptions for order lifecycle events.

Base URL

https://mindswap.fun/api/v3

When to use the Business API

• Classic partner API integration
• Server-to-server authentication with API key and secret
• Strong replay protection
• Webhook subscriptions for order lifecycle events
• Order management without wallet signature requirements
• Single-channel route discovery for private/offchain, onchain DEX, and gasless-capable execution paths

Happy path

1. Call GET /api/v3 to confirm the surface is mounted.
2. Call GET /api/v3/currencies to build supported pair selectors.
3. Call GET /api/v3/routes to discover available private/offchain and onchain routes. Keep walletAddress as the source signer; pass recipientAddress separately for cross-namespace destination recipients such as Mayan EVM-to-Solana flows.
4. For offchain routes, call POST /api/v3/routes/resolve and create the order with POST /api/v3/orders.
5. For onchain routes, call POST /api/v3/onchain/routes/resolve, report the signed or broadcast execution, then poll onchain status.
6. Call POST /api/v3/quotes only when you need the direct quote/order path.
7. Poll GET /api/v3/orders/{orderId} or GET /api/v3/orders/{orderId}/status.
8. Optionally attach email notifications, fetch QR assets, or register webhooks.
9. If needed, call POST /api/v3/orders/{orderId}/emergency.