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/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-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-fc5b81a0

ClawBank — Live wallet balance - native ETH plus any ERC20 tokens in one call via eth_getBalance and balanceOf on OneSource 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-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-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-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-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-42861fc7

ClawBank — Contract introspection via eth_call - name, symbol, decimals, and ERC20/721/1155 interface support

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

ClawBank — ERC20 Transfer logs via eth_getLogs - decoded sender, recipient, and amount for a token or wallet

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

ClawBank — NFT metadata, traits, and image URI for any ERC721 or ERC1155 token - fetched via eth_call with IPFS resolution (OneSource live Ethereum RPC)

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-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-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-186c1e8c

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

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/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-52d4391e

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

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-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-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/stableenrich-dev-68a3bc52

ClawBank — Exa Search - Neural search across the web

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-onesource-io-f1ede457

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

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/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/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/stableenrich-dev-ebe3df2a

ClawBank — Exa Contents - Retrieve content from URLs

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

ClawBank — PDL Person Enrich — career history, emails, phone. Requires one of: `email`, `profile` (LinkedIn URL), or `first_name` + `last_name` + (`company_name` OR `company_domain`). `{ firs

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

ClawBank — FullEnrich People Search — filter by company domain/name/LinkedIn URL, seniority, title, location, skills, and 20+ FullEnrich filters. Default lean roster: companies map + company_

https://app.clawbank.co/x402/proxy/memegeneratorx402-vercel-app-ffa8a429

ClawBank — Generate a captioned meme image. Pay per request in USDC on Base mainnet.

https://app.clawbank.co/x402/proxy/randomfactsx402-vercel-app-a4619910

ClawBank — Returns a single random fact as JSON in exchange for a micropayment.

https://app.clawbank.co/x402/proxy/api-loyalspark-online-71bd66d5

ClawBank — Onchain loyalty platform on Base Network. Businesses launch branded rewards in minutes. Customers earn real value with every purchase. AI agents automate the rest.

https://app.clawbank.co/x402/proxy/coinflip402-vercel-app-716320d3

ClawBank — Flip a coin for a small USDC payment on Base mainnet. Returns heads or tails.

https://app.clawbank.co/x402/proxy/x402lifeadvice-vercel-app-d66fa6a4

ClawBank — Get one piece of thoughtful life advice, paid per request over x402.

https://app.clawbank.co/x402/proxy/riddlex402-vercel-app-e1dd5a24

ClawBank — Pay a micro-fee in USDC on Base mainnet to receive a riddle and its answer.

https://app.clawbank.co/x402/proxy/dicex402-vercel-app-a5a90675

ClawBank — Roll a dice with any number of faces. Specify faces via ?faces=N query parameter.

https://app.clawbank.co/x402/proxy/ladyfortunalx402-vercel-app-7e50c7ba

ClawBank — Get a random fortune via x402 payment on Base mainnet.

https://app.clawbank.co/x402/proxy/x402wordoftheday-vercel-app-bbb9729b

ClawBank — Get today's curated Word of the Day (definition + part of speech).

https://app.clawbank.co/x402/proxy/x402uselessfacts-vercel-app-592914ea

ClawBank — Pay a tiny amount of USDC and receive one delightfully useless fact.

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.