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/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-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-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-2fb25982

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

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

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

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-a32d62b1

ClawBank — Ethereum network info - chain ID, block height, and gas price in one batched RPC call (eth_chainId + eth_blockNumber + eth_gasPrice)

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

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

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-96138f5e

ClawBank — Pending Ethereum block - mempool 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-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-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-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-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-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-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-09553328

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

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

ClawBank — Exa Search - Neural search across the web

https://app.clawbank.co/x402/proxy/www-hibra-app-22241ee2

ClawBank — Hibra AI Swap — best route on Base network

https://app.clawbank.co/x402/proxy/api-apify-com-e4321478

ClawBank — Apify Store is the largest marketplace of tools for AI agents. Extract data from any website and automate your workflows with thousands of scrapers, crawlers, and automation tools

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/api-interzoid-com-03e2ab23

ClawBank — Detect the language of input text and translate it to any specified target language. AI-powered translation supporting numerous world languages.

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

ClawBank — Exa Contents - Retrieve content from URLs

https://app.clawbank.co/x402/proxy/stableupload-dev-d39056e7

ClawBank — Buy an upload slot. Agent uploads file via returned URL.

https://app.clawbank.co/x402/proxy/2s-io-f7734167

ClawBank — Convert a value between units of measure: mass (g, kg, mg, lb, oz, t, st), length (m, km, cm, mm, in, ft, yd, mi), volume (l, ml, m3, gal, gal-imp, qt, pt, cup, floz, tbsp, tsp), a

https://app.clawbank.co/x402/proxy/2s-io-b7f1bc69

ClawBank — Decode a 17-character VIN to manufacturer-supplied vehicle metadata via NHTSA's vPIC database. Returns identity (year, make, model, trim, series, body class, manufacturer), assembl

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/2s-io-d55dea1d

ClawBank — List the official holidays for a country and year, with exact observed dates including substitute days (e.g. a Saturday July 4th observed on Friday). Query: country (ISO 3166-1 alp

https://app.clawbank.co/x402/proxy/2s-io-7b502a1e

ClawBank — Holiday-aware business-day calculator for 200+ countries. Three modes: pass start + addDays (signed integer) to shift a date by N business days; pass start + end to count business

https://app.clawbank.co/x402/proxy/2s-io-7a3547e2

ClawBank — Decode a 3-character World Manufacturer Identifier (the first three characters of a VIN) to the assigning manufacturer. Returns full manufacturer legal name, common short name, mak

https://app.clawbank.co/x402/proxy/2s-io-4f38eb66

ClawBank — Forward geocoding — free-text address or place name → latitude/longitude plus structured address components (houseNumber, road, suburb, city, county, state, postcode, country, coun

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.