ClawBank
No account No API keys Pay per call

The ClawBank XRPL x402 Gateway

The Base x402 catalog, payable in RLUSD and XRP on the XRP Ledger. Your agent asks, gets a price, pays on-ledger, and gets the result — ClawBank settles the USDC side so you never have to leave XRPL.

How it works

1

Ask

Call any gateway endpoint. It answers HTTP 402 with a live RLUSD price — the upstream's own cost plus 10.0% — and a single-use invoice valid for 10 minutes.

2

Pay

Retry with a presigned XRPL payment bound to the invoice. Verification and settlement run through the T54 facilitator — ClawBank never touches your transaction. Holding only XRP? The payment converts to RLUSD mid-flight, atomically, on the XRPL DEX.

3

Get the result

ClawBank pays the upstream service in USDC on Base and streams the response back to you. If the upstream fails, your payment is never settled — you are never charged for a call that didn't deliver.

Try it from a terminal

Step 1 needs nothing but curl — the 402 response carries the price and payment requirements in the standard PAYMENT-REQUIRED header. Any x402-XRPL client (e.g. x402-xrpl on npm/PyPI) handles step 2 for you — or build the header yourself with the step-by-step walkthrough below. 

curl -si https://app.clawbank.co/x402/proxy/<service>
HTTP/1.1 402 Payment Required
payment-required: eyJ4NDAyVmVyc2lvbiI6Miw…   # price, payTo, invoiceId
# pay with any x402-xrpl client, then retry with PAYMENT-SIGNATURE:
curl -s https://app.clawbank.co/x402/proxy/<service> -H "PAYMENT-SIGNATURE: <payload>"
HTTP/1.1 200 OK   # your data, payment settled on XRPL

Constructing PAYMENT-SIGNATURE, step by step

For integrators building the payment header by hand — most clients never need this. Expand for the full walkthrough.

The header is not a JWT, an API key, or a payment hash — it is a base64-encoded JSON envelope carrying a presigned XRPL Payment transaction. You sign it with your own key; the T54 facilitator (not ClawBank) submits it to the ledger after your result is delivered.

1. Decode the challenge

The 402's PAYMENT-REQUIRED response header is base64 JSON. Its accepts[0] entry holds everything you need: 

{"x402Version": 2,
 "resource": {"url": "…/x402/proxy/<service>"},
 "accepts": [{
   "scheme": "exact",
   "network": "xrpl:0",
   "asset": "524C5553…",             // RLUSD 40-hex currency code
   "amount": "0.011",                // RLUSD, decimal string
   "payTo": "r…",                    // destination r-address
   "maxTimeoutSeconds": 600,
   "extra": {
     "issuer": "r…",                 // RLUSD issuer
     "invoiceId": "INV-…",           // single-use, 10-minute expiry
     "sourceTag": 804681468,
     "crossCurrency": true           // may fund from XRP via SendMax
   }}]}

2. Build an XRPL Payment from it

The Memo binds the transaction to the single-use invoice — without it, verification fails. 

{"TransactionType": "Payment",
 "Account": "<your r-address>",
 "Destination": "<payTo>",
 "Amount": {"currency": "<asset>", "issuer": "<extra.issuer>", "value": "<amount>"},
 "SendMax": <same object as Amount — or an XRP drops cap when paying from XRP>,
 "SourceTag": <extra.sourceTag>,
 "Memos": [{"Memo": {"MemoData": "<HEX(UTF8(invoiceId))>"}}],
 "InvoiceID": "<SHA-256(invoiceId), hex>"}   // belt-and-suspenders, optional

Holding only XRP? Keep Amount as the quoted RLUSD and set SendMax to an XRP cap in drops (live DEX quote + slippage headroom) — the ledger converts atomically mid-payment, and you can never spend past the cap.

3. Sign it — but don't submit it

Sign locally with your own key (include a LastLedgerSequence so the transaction expires harmlessly). The output is the signed transaction blob, a hex string. Never submit it to the ledger yourself — the facilitator does that during settlement, after the upstream delivers.

4. Wrap, encode, retry

Echo the accepts[0] entry you're paying verbatim as accepted, add your blob, then base64-encode the whole envelope into the header: 

{"x402Version": 2,
 "resource": {"url": "…same as the challenge…"},
 "accepted": { …the accepts[0] entry, unchanged… },
 "payload": {"signedTxBlob": "1200002280…"}}
curl -s https://app.clawbank.co/x402/proxy/<service> \
  -H "PAYMENT-SIGNATURE: <base64 of the envelope above>"

5. Read the receipt

A 200 carries your data plus a PAYMENT-RESPONSE header — base64 JSON with the settled XRPL transaction hash. If verification fails, nothing is charged and the invoice stays redeemable: fix the transaction, re-sign, and retry within the 10-minute window.

The fine print, up front

  • • Transparent pricing. Every quote is the upstream service's live price plus a flat 10.0% gateway fee, denominated in RLUSD (USD-pegged). No subscriptions, no minimums.
  • • Never charged on failure. Payment settles only after the upstream delivers — verify, fulfill, then settle. Single-use invoices make replays impossible.
  • • Pay in XRP or RLUSD. Prices are quoted in RLUSD; payments may be funded from XRP in one atomic cross-currency transaction — no trust line or manual swap needed.
  • • GET and POST. Tool-style services take their inputs as a JSON body; the body you're quoted on is the body that runs.

Live services

Auto-curated from the most-used services in the x402 economy, refreshed continuously. Agents browse the catalog programmatically — names, descriptions, and indicative prices per slug — at /x402/catalog, or fetch the standard discovery document at /.well-known/x402.

These services come from the open x402 catalog — you can browse and pay for them directly (in USDC on Base) at agentic.market. The gateway just lets you pay for them in XRP or RLUSD on the XRP Ledger instead.

https://app.clawbank.co/x402/proxy/exa-search

ClawBank — Exa neural web search: semantic search across the live web, first-party api.exa.ai endpoint

https://app.clawbank.co/x402/proxy/exa-contents

ClawBank — Exa page contents: clean text extraction for any URL, first-party api.exa.ai endpoint

https://app.clawbank.co/x402/proxy/tavily-search

ClawBank — Tavily AI search: real-time web search built for AI agents, first-party x402.tavily.com endpoint

https://app.clawbank.co/x402/proxy/browserbase-session

ClawBank — Browserbase cloud browser session with prepaid time: returns a WebSocket connect URL for browser automation

https://app.clawbank.co/x402/proxy/apify-tokens

ClawBank — Apify prepaid tokens: run any of thousands of scrapers and automation tools on the Apify platform

https://app.clawbank.co/x402/proxy/claude-inference

ClawBank — Anthropic Claude Haiku 4.5 inference over MCP streamable HTTP, via the Yeetful x402 gateway

https://app.clawbank.co/x402/proxy/llm-chat

ClawBank — OpenAI-compatible LLM chat completions (streaming supported), via glim.sh

https://app.clawbank.co/x402/proxy/firecrawl-search

ClawBank — Firecrawl web search: search the web and get clean, LLM-ready results, via StableEnrich

https://app.clawbank.co/x402/proxy/reddit-search

ClawBank — Search Reddit posts and discussions, via StableEnrich

https://app.clawbank.co/x402/proxy/x-user-profile

ClawBank — Look up an X/Twitter profile by handle: bio, follower and tweet counts, verification status, via twit.sh

https://app.clawbank.co/x402/proxy/x-tweet-search

ClawBank — Search recent tweets on X/Twitter, via twit.sh

https://app.clawbank.co/x402/proxy/polymarket-markets

ClawBank — Query Polymarket prediction markets with filtering, sorting, and pagination, via BlockRun.AI

https://app.clawbank.co/x402/proxy/quotient-signals

ClawBank — Quotient's published prediction-market trade signals: side, entry prices, conviction tier, capacity, and convergence read from Q's AI forecasting pipeline (world events: elections, geopolitics, central-bank policy)

https://app.clawbank.co/x402/proxy/quotient-featured-signal

ClawBank — Quotient's single highlighted prediction-market signal of the day (may legitimately be empty)

https://app.clawbank.co/x402/proxy/quotient-markets

ClawBank — Prediction markets covered by Quotient's AI forecaster, with current odds and forecast freshness; filter by topic or changed_within

https://app.clawbank.co/x402/proxy/quotient-market-lookup

ClawBank — Batch forecast intel for up to 10 prediction markets by Polymarket slugs= or condition_ids= query param: Q's probability, thesis, and what-changed deltas

https://app.clawbank.co/x402/proxy/otto-crypto-news

ClawBank — Real-time crypto market news with sentiment analysis and top headlines ranked by importance

https://app.clawbank.co/x402/proxy/otto-funding-rates

ClawBank — Cross-venue perp funding rates, open interest, long/short ratios, whale positions, and liquidations

https://app.clawbank.co/x402/proxy/otto-trending-altcoins

ClawBank — Top trending altcoins from news and Twitter analysis. DYOR

https://app.clawbank.co/x402/proxy/otto-hyperliquid

ClawBank — Hyperliquid perpetuals market data: mark/oracle price, funding rate, open interest, and size specs

https://app.clawbank.co/x402/proxy/token-price

ClawBank — USD price for any major token by symbol or chain+contract, via Anchor

https://app.clawbank.co/x402/proxy/wallet-screening

ClawBank — Sanctions and AML screening for any wallet address, via Anchor

https://app.clawbank.co/x402/proxy/www-ax1-vc-124c7216

ClawBank — Send a Base token contract address, get an AI-written verdict: onchain metrics, a plain-language take, and a shareable verdict card. Entertainment, not trading advice.

https://app.clawbank.co/x402/proxy/api-onesource-io-5e78c72e

ClawBank — ERC20 token balance for any Ethereum wallet - USDC, USDT, DAI, or any token - via balanceOf (eth_call) on OneSource live Ethereum RPC

https://app.clawbank.co/x402/proxy/api-onesource-io-2fb25982

ClawBank — Latest Ethereum block height - current chain tip via eth_blockNumber

https://app.clawbank.co/x402/proxy/api-onesource-io-fc5b81a0

ClawBank — Live wallet balance - native ETH plus up to 20 caller-supplied ERC20 tokens in one bounded RPC batch

https://app.clawbank.co/x402/proxy/api-onesource-io-7cf7735a

ClawBank — ERC20 Transfer logs via eth_getLogs - raw Transfer events for a token or wallet

https://app.clawbank.co/x402/proxy/api-onesource-io-42861fc7

ClawBank — Best-effort contract introspection via batched RPC - bytecode presence, token metadata, and ERC20-like/ERC721/ERC1155 classification

https://app.clawbank.co/x402/proxy/api-onesource-io-47b08bda

ClawBank — Fetch an Ethereum block header and transaction hashes by number, tag, or hex via eth_getBlockByNumber

https://app.clawbank.co/x402/proxy/api-onesource-io-09553328

ClawBank — Total supply of an ERC20 or ERC721 token contract via totalSupply (eth_call)

https://app.clawbank.co/x402/proxy/api-onesource-io-76709e7e

ClawBank — ENS resolve - turn a .eth name into an address, or an address into its primary .eth name, via eth_call on OneSource live Ethereum RPC

https://app.clawbank.co/x402/proxy/api-onesource-io-2f828f66

ClawBank — Next transaction nonce for any Ethereum wallet via eth_getTransactionCount - how many txs it has sent

https://app.clawbank.co/x402/proxy/api-onesource-io-1deebeab

ClawBank — Deepstate, the on-chain order-book exchange on Robinhood Chain. Order-book snapshot for a market, bids descending and asks ascending, with live resting size per level.

https://app.clawbank.co/x402/proxy/api-onesource-io-a32d62b1

ClawBank — EVM network info - chain ID, block height, gas price, chain head age, and chain characteristics in one batched RPC call (eth_chainId + eth_blockNumber + eth_gasPrice + latest block

https://app.clawbank.co/x402/proxy/api-onesource-io-0c6b83a7

ClawBank — Deepstate, the on-chain order-book exchange on Robinhood Chain. Rolling 24h / 7d / 30d volume and price change for a market.

https://app.clawbank.co/x402/proxy/api-onesource-io-3c922e6a

ClawBank — Deepstate, the on-chain order-book exchange on Robinhood Chain. OHLCV candles for a market.

https://app.clawbank.co/x402/proxy/api-onesource-io-0a64c864

ClawBank — Deepstate, the on-chain order-book exchange on Robinhood Chain. Lists the markets this service serves with their token layout (base, quote, token0/token1, decimals).

https://app.clawbank.co/x402/proxy/api-onesource-io-7746307f

ClawBank — Deepstate, the on-chain order-book exchange on Robinhood Chain. Trade tape for a market, newest first.

https://app.clawbank.co/x402/proxy/api-onesource-io-66d24855

ClawBank — Full Ethereum transaction details by hash via eth_getTransactionByHash - from, to, value, calldata, block

https://app.clawbank.co/x402/proxy/api-onesource-io-58702b1b

ClawBank — Query Ethereum contract event logs via eth_getLogs - filter by contract, topic, and block range

https://app.clawbank.co/x402/proxy/api-onesource-io-a317afee

ClawBank — Transaction receipt via eth_getTransactionReceipt - status, gas, and event logs for a mined Ethereum transaction

https://app.clawbank.co/x402/proxy/api-onesource-io-1ce5733d

ClawBank — Ethereum chain ID (EIP-155) via eth_chainId - confirm which chain a network is on

https://app.clawbank.co/x402/proxy/api-onesource-io-50e48b33

ClawBank — List every ERC721 NFT token_id a wallet owns in a collection via tokenOfOwnerByIndex (eth_call)

https://app.clawbank.co/x402/proxy/api-onesource-io-61326676

ClawBank — ERC20 allowance via allowance (eth_call) - how much a spender is approved to move from an owner's wallet

https://app.clawbank.co/x402/proxy/api-onesource-io-8b8e9e40

ClawBank — NFT metadata for ERC721 or ERC1155 tokens via eth_call, with IPFS, Arweave, data URI, and public HTTP(S) resolution

https://app.clawbank.co/x402/proxy/api-onesource-io-0f2f2282

ClawBank — Check if an Ethereum address is a contract via eth_getCode - returns deployed bytecode

https://app.clawbank.co/x402/proxy/api-onesource-io-80fde8df

ClawBank — Deepstate, the on-chain order-book exchange on Robinhood Chain. Per-maker time-at-top, notional rested, fills, and maker rewards earned for a market (token varies by market; see /d

https://app.clawbank.co/x402/proxy/api-onesource-io-186c1e8c

ClawBank — Estimate the gas a transaction will consume via eth_estimateGas before signing it

https://app.clawbank.co/x402/proxy/api-onesource-io-2b95ad38

ClawBank — Deepstate, the on-chain order-book exchange on Robinhood Chain. Depth heatmap - resting order size by price level over time for a market.

https://app.clawbank.co/x402/proxy/api-onesource-io-52d4391e

ClawBank — Simulate a read-only Ethereum contract call via eth_call - no transaction sent

https://app.clawbank.co/x402/proxy/api-onesource-io-4d1c6c7c

ClawBank — Deepstate, the on-chain order-book exchange on Robinhood Chain. Gas spent resting and cancelling orders for a market.

https://app.clawbank.co/x402/proxy/stableenrich-dev-68a3bc52

ClawBank — Exa Search - Neural search across the web

https://app.clawbank.co/x402/proxy/api-onesource-io-fcf45527

ClawBank — Look up the current owner of an ERC721 NFT by token_id via ownerOf (eth_call)

https://app.clawbank.co/x402/proxy/api-onesource-io-42e5249d

ClawBank — ERC1155 token balance via balanceOf (eth_call) - how many copies of a token_id a wallet holds

https://app.clawbank.co/x402/proxy/tick-hugen-tokyo-7c0731fb

ClawBank — Get real-time Best Bid/Ask for any FX pair, aggregated from multiple institutional liquidity providers. 62-88% tighter spreads than any single source. Includes quality metadata (fr

https://app.clawbank.co/x402/proxy/api-onesource-io-86b8598e

ClawBank — Detect upgradeable proxy patterns (EIP-1967, UUPS, Transparent) via eth_getStorageAt - returns the implementation address behind a proxy

https://app.clawbank.co/x402/proxy/api-onesource-io-f1ede457

ClawBank — Read a raw storage slot from any Ethereum contract via eth_getStorageAt

https://app.clawbank.co/x402/proxy/tick-hugen-tokyo-3ba15b3b

ClawBank — Get real-time Best Bid/Ask for ALL available FX pairs in a single call. Multi-source aggregated from multiple institutional LPs with 62-88% spread improvement. Returns 14 FX pairs

https://app.clawbank.co/x402/proxy/tick-hugen-tokyo-296163dc

ClawBank — List all available FX symbols with their current quality state and source count. AI agent API for discovering available instruments before subscribing to tick data. Accepts USDC pa

https://app.clawbank.co/x402/proxy/api-onesource-io-96138f5e

ClawBank — Pending block - transactions not yet mined, via eth_getBlockByNumber("pending")

https://app.clawbank.co/x402/proxy/api-oblique-markets-89f547ac

ClawBank — Use when an agent needs a trusted UTC timestamp or the smallest end-to-end test of its x402 payment client. Returns Current server time as ISO 8601 and Unix epoch milliseconds, ret

https://app.clawbank.co/x402/proxy/stableenrich-dev-ebe3df2a

ClawBank — Exa Contents - Retrieve content from URLs

https://app.clawbank.co/x402/proxy/crypto-apitoll-cloud-00a389cd

ClawBank — Latest crypto token prices by ticker symbol, CoinGecko id, or chain:address (BTC, ETH, SOL, or base:0x…): current spot price, token symbol, decimals, and a confidence score, for up

https://app.clawbank.co/x402/proxy/x402-ottoai-services-9ded9898

ClawBank — DeFi yield farming markets with live APYs across Aave V3 and Morpho on Base, Ethereum, and other major chains. Find the best stablecoin yield (USDC) and ETH yield for idle capital:

Want it even easier?

A ClawBank account adds Manfred — an agent that discovers, pays for, and uses x402 services for you — plus self-custody wallets on Base and XRPL, spending budgets, and automatic XRP ⇄ RLUSD ⇄ USDC conversion.

Create an account API docs

x402 is an open protocol. XRPL verification and settlement by the T54 facilitator.