MindSwap API Documentation
The practical, developer-first guide to MindSwap's two supported integration surfaces.
Which API should you use?
| Surface | Base path | Best for | Auth model |
|---|---|---|---|
| Business API | https://mindswap.fun/api/v3 | Partners, dashboards, embedded integrations, backend-to-backend systems | HMAC-signed requests with API key permissions |
| x402 API | https://mindswap.fun/api/x402 | Paid machine clients, bots, wallet-native automations, SIWX-enabled reads | x402 pay-and-retry for paid routes plus SIWX for wallet-bound GET reads |
Choose Business API if you have partner credentials and want a predictable signed API. Choose x402 API if your client can satisfy an x402 payment challenge and use SIWX for wallet-bound reads.
Key strengths
Business API
- Straightforward quote and order flows
- Webhook management and email notifications
- QR retrieval for deposit instructions
- Classic server-to-server authentication
x402 API
- Official x402 flow on
/api/x402 - Paid routes with a linear
402challenge and replay path - Wallet-bound GET reads with
SIGN-IN-WITH-X - Same quote, order, routing, and market-intel core as the Business API