x402 payments

RAVN’s quote and execute are also sold per call over x402: no key, no signup, nothing to leak. Agents can find RAVN through Coinbase’s x402 Bazaar and x402scan. If you don’t need that, the MCP server and REST API are free.

Endpoint	Price	Same as
`POST https://app.ravn.exchange/api/v1/x402/quote`	$0.001	`POST /quote`
`POST https://app.ravn.exchange/api/v1/x402/execute`	$0.01	`POST /execute`

Paid in USDC on Base or Solana. Bodies, responses and errors match the free endpoints, and a quoteToken works on either. Status, submit and every other call stay free: use the normal endpoints.

You pay only for a success. An error (any 4xx or 5xx, such as NO_LIQUIDITY or QUOTE_EXPIRED) costs nothing.
Each IP has 30 slots, held by its failed calls (for about a minute) and its calls still running. With none free, its calls get 429 RATE_LIMITED: retry after details.retryAfterSec, and fix any request that keeps failing.
A payment buys one call. Sending it again gets 400: let your client sign a new one.
The price pays for the call, not the swap. Send your x-api-key too and the quote carries your fee; without one it’s 0.
/x402/quote ignores broadcastViaRavn (a free /quote made with it still executes on /x402/execute), and refuses call (400 INVALID_REQUEST): quote calls on the free /quote with a key. Hinkal and Fynd aren’t offered: execute them on the free endpoints.
sandbox: true works, but the call is still charged.

How it works

Call the endpoint. RAVN answers 402 with the payment terms in the payment-required header (base64; the body is an empty {}).
Your x402 client signs a USDC payment and retries with it attached.
RAVN runs the call, settles the payment only if it succeeded, and returns the normal response.

x402 client libraries do steps 2 and 3 for you:

import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
import { ExactEvmScheme, toClientEvmSigner } from "@x402/evm";

const core = new x402Client();
core.register("eip155:*", new ExactEvmScheme(toClientEvmSigner(yourEvmWalletClient)));
const x402Fetch = wrapFetchWithPayment(fetch, core);

const res = await x402Fetch("https://app.ravn.exchange/api/v1/x402/quote", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({
    inputChainId: 1,
    outputChainId: -2,
    inputToken: "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
    outputToken: "So11111111111111111111111111111111111111112",
    inputAmount: "1000000000000000000",
    userAddress: "0xYourAddress",
    destinationAddress: "YourSolanaAddress",
  }),
});
const { data } = await res.json(); // includes quoteToken

Pay from Solana with @x402/svm instead. If x402 is switched off, both endpoints answer 503 NOT_CONFIGURED: use the free ones.