x402 API Endpoints

Complete reference for the approved /api/x402 contract. Paid routes cost a flat $0.05 per call, settled on Base via an x402 payment (pay-and-retry on 402 Payment Required). Wallet-bound reads are free but require a valid SIGN-IN-WITH-X (SIWX) proof and ownership of the resource.

Bootstrap & catalog

GET/api/x402

Readiness documentFree. Safe bootstrap route for x402 clients.

GET/api/x402/currencies

Supported currency catalogPaid $0.05.

GET/api/x402/tokens/popular

Popular token shortlistPaid $0.05.

GET/api/x402/tokens/search

Search tokens by symbol or namePaid $0.05. Query param q.

GET/api/x402/tokens/by-address

Resolve a token by chain + contract addressPaid $0.05. Params chain, address.

GET/api/x402/tokens/logo

Token logo asset lookupPaid $0.05.

Routing & quotes

GET/api/x402/routes

List paid route inventoryPaid $0.05. Private/offchain plus Onchain DEX & Bridge routes; keep walletAddress as the source signer and pass recipientAddress for cross-namespace recipients (e.g. Mayan EVM→Solana).

POST/api/x402/routes/resolve

Resolve a route quotePaid $0.05 + SIWX.

POST/api/x402/quotes

Create a paid quote (legacy)Paid $0.05. Not used for Wormhole bridge route cards.

POST/api/x402/onchain/routes/resolve

Resolve an onchain routePaid $0.05 + SIWX (wallet must match). Use the routeQuoteId from /routes; returns executionAccessToken.

POST/api/x402/onchain/executions

Report onchain executionPaid $0.05 + SIWX. Also send X-Onchain-Execution-Access-Token.

GET/api/x402/onchain/executions/{executionPlanId}

Read execution statusFree (SIWX). Requires the execution access token.

Orders

POST/api/x402/orders

Create a paid orderPaid $0.05 + SIWX. Binds the order to your wallet; requires Idempotency-Key.

GET/api/x402/orders/{orderId}

Read normalized orderFree (SIWX). Wallet must own the order.

POST/api/x402/orders/{orderId}/emergency

Trigger emergency actionPaid $0.05 + SIWX + ownership.

POST/api/x402/orders/{orderId}/refund

Request a refundPaid $0.05 + SIWX + ownership.

POST/api/x402/orders/{orderId}/notifications/email

Attach email notificationPaid $0.05 + SIWX + ownership.

GET/api/x402/orders/{orderId}/qr

Fetch deposit QR imagesFree (SIWX) + ownership.

Market intelligence

POST/api/x402/market-intel/jobs

Create market-intel jobPaid $0.05 + SIWX. 200 for replay or 202 for a new job.

GET/api/x402/market-intel/jobs/{jobId}

Read market-intel jobFree (SIWX) + ownership.

Payment Flow

Payment Headers