x402 API Endpoints
Complete reference for the approved /api/x402 contract.
| Route | Purpose | Notes |
|---|---|---|
GET /api/x402 | Readiness document | Safe bootstrap route for x402 clients |
POST /api/x402/quotes | Create a paid quote | Legacy quote path; not used for Wormhole bridge route cards |
POST /api/x402/orders | Create a paid order | Uses x402 pay-and-retry plus SIGN-IN-WITH-X |
GET /api/x402/orders/{orderId} | Read normalized order | Wallet-bound GET with SIGN-IN-WITH-X |
POST /api/x402/orders/{orderId}/emergency | Trigger emergency action | Paid wallet-bound route |
GET /api/x402/routes | List paid route inventory | Paid GET for private/offchain plus Onchain DEX & Bridge routes; keep walletAddress as the source signer and pass recipientAddress for cross-namespace recipients such as Mayan EVM-to-Solana discovery |
POST /api/x402/routes/resolve | Resolve route quote | Paid route returning route-specific output |
POST /api/x402/onchain/routes/resolve | Resolve onchain route | Use the Wormhole routeQuoteId from /routes; returns executionAccessToken |
POST /api/x402/onchain/executions | Report onchain execution | Paid wallet-bound route; also send X-Onchain-Execution-Access-Token |
GET /api/x402/onchain/executions/{executionPlanId} | Read execution status | Wallet-bound GET plus execution access token |
POST /api/x402/market-intel/jobs | Create market-intel job | Paid wallet-bound route; 200 for replay or 202 for a new job |
GET /api/x402/market-intel/jobs/{jobId} | Read market-intel job | Wallet-bound GET with SIGN-IN-WITH-X |