x402 Payments

• No key to provision, rotate, or leak. Nothing to store server-side; a compromised agent process has no standing secret to revoke.
• Spend is capped per call, not per key. Each payment authorizes exactly one request for exactly the price quoted; there’s no API key that, once leaked, keeps working until someone notices and rotates it.
• The payment itself is the audit trail. Every call settles on-chain (Base or Solana), so usage is independently verifiable without RAVN-side logging or an API dashboard.
• Discoverable by other agents, not just yours. RAVN’s x402 routes are indexed in Coinbase’s x402 Bazaar catalog (the search and merchant-lookup API behind agentic.market) and listed on x402scan.com, so agents that discover services by querying that catalog directly can find and call RAVN without being told about it in advance. Whether RAVN also appears in agentic.market’s own curated marketplace UI is a separate, usage-driven decision on their end, not something indexing alone guarantees. The free REST/MCP doors aren’t part of the Bazaar catalog at all.

​

Endpoints

​

Accepted payment

​

How it works

1. Call the endpoint with no payment attached.
2. RAVN responds 402 with a payment-required header describing accepted payment options (network, asset, amount, recipient).
3. Your x402 client signs a payment (an EIP-3009 USDC authorization on Base, or a Solana USDC transfer) and retries the request with a payment-signature-style header attached.
4. RAVN verifies and settles the payment via its facilitator, then executes your original request and returns the normal response.

​

Example

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: 8453,
    inputToken: "0xEeeeeEeeeEeEeeEeEeEeeeEEeeeeEeeeeeeeEEeE",
    outputToken: "0xEeeeeEeeeEeEeeEeEeEeeeEEeeeeEeeeeeeeEEeE",
    inputAmount: "1000000000000000000",
    userAddress: "0xYourAddress",
  }),
});

const { data } = await res.json(); // includes quoteToken

​

Errors