Architecture

MindSwap does not run separate quote engines or order systems for Business API and x402 consumers. Both APIs sit on top of the same external application core.

Shared core services

Currencies catalog
Quotes
Orders
Emergency actions
Routing
Market-intel jobs
Webhook delivery

What changes between surfaces

The core business objects are shared — what differs is the edge contract:

Business API adds HMAC authentication, API key permissions, business quotas, and webhook administration.
x402 API adds x402 payment challenges for paid routes and SIWX verification for wallet-bound reads.

This means:

Quote requests use the same fromCcy, toCcy, amount, direction, and type vocabulary
Order responses normalize into the same order shape
Route analysis uses the same routing core

Hosts and readiness checks

Canonical external host:

https://mindswap.fun

Readiness endpoints (safe, no data creation):

GET https://mindswap.fun/api/v3
GET https://mindswap.fun/api/x402

Introduction

Common Patterns