SIWX Wallet-Bound Routes

Wallet-bound x402 routes use SIGN-IN-WITH-X. This is SIWX for x402, not a MindSwap-specific wallet protocol.

Where SIWX applies

Paid wallet-bound mutations

• POST /api/x402/orders
• POST /api/x402/orders/{orderId}/emergency
• POST /api/x402/onchain/routes/resolve
• POST /api/x402/onchain/executions
• POST /api/x402/market-intel/jobs

Wallet-bound reads

• GET /api/x402/orders/{orderId}
• GET /api/x402/market-intel/jobs/{jobId}
• GET /api/x402/onchain/executions/{executionPlanId}

Required header

Send a single SIGN-IN-WITH-X header containing the SIWX proof for the wallet principal that should have access.

MindSwap-specific notes

MindSwap uses SIWX here for wallet-bound x402 routes. You do not need Reown SIWX specifically. Any client that can produce a valid SIWX proof for the requested wallet can call these routes.

Onchain execution status also still requires X-Onchain-Execution-Access-Token in addition to the SIWX proof.

Read behavior

• A valid SIWX proof can unlock a resource already associated with that wallet.
• Wallet-bound reads are not repaid on every read.
• The response body is the normal MindSwap JSON envelope for the resource.

GET https://mindswap.fun/api/x402/orders/ord_123
SIGN-IN-WITH-X: <base64-encoded SIWX payload>