xrplme.online - API Docs

How x402 payment works

Each endpoint returns 402 Payment Required. Pay the invoice (XRP on XRPL or USDC on Solana), then retry the request to receive data.

1

Send query — POST your query to the endpoint. You get a 402 response with payment instructions.

2

Scan QR — Open the QR code in Xaman or Joey wallet (XRP) or any Solana Pay wallet (USDC). Pay the invoice.

3

Retry — After payment, click "Retry after payment" to re-send the same query. The endpoint returns your data.

No USDC? Fund your wallet with a card

The rails accept XRP on the XRP Ledger or USDC on Solana. If you hold neither, buy USDC with a debit or credit card at Crossmint — Apple Pay and Google Pay work — with your own Solana wallet as the destination, then pay the endpoint from that wallet.

Three things worth knowing:

This site has no card checkout and no account system. We never hold your funds and never ask for a private key or seed phrase.
The 402 response tells your agent the exact amount and receiving address. Your agent pays that amount in USDC and retries the same request.
Agents that already hold USDC or XRP skip this step entirely — they just pay the 402.

All 90 countries, endpoints and prices are listed on the countries page.

Endpoint tester

Select a country, payment rail, and endpoint type, type your query, and pay to get results.

Country

Payment rail

XRP 1 XRP/ 5 XRP

USDC $1.00 / $7.00

Endpoint type

Standard

Factual Data, Fast

AI Enhanced

Smart Analysis

Your query

Endpoint URL

POST https://xrplme.online/wc/v1/hong_kong/bot

Response

Click "Send Query" to start.

Example queries

Same request format for both endpoints. Paste these into the tester above.

Standard API example (1 XRP / 1 USDC)

"What are Thailand business registration requirements?" — Returns scraped government data from Thai government sources. Fast, factual. 1 XRP on XRPL / 1 USDC on Solana.

AI Enhanced example (5 XRP / 7 USDC)

"Compare Thailand vs Vietnam for tech startup - which is better and why?" — AI analyzes scraped data from both countries, provides comparison reasoning. 5 XRP on XRPL / 7 USDC on Solana.

Request format

Both endpoints accept the same JSON body.

POST https://xrplme.online/wc/v1/{country}/{endpoint}
Content-Type: application/json

{
  "message": "Your query here",
  "session_id": "your-session-id-123"
}

Country codes: thailand, vietnam, japan, korea, india, usa, canada, uae, uk, philippines, singapore, australia, germany, france, brazil, mexico, switzerland, netherlands, hong_kong, italy, malaysia, indonesia, taiwan, macau, newzealand. Endpoints: /bot (1 XRP / 1 USDC) or /bot/ai (5 XRP / 7 USDC).

cURL examples

Copy and paste to test from your terminal. Works for humans AND AI agents.

Standard API — 1 XRP (XRPL)

curl -X POST https://xrplme.online/wc/v1/thailand/bot \

  -H "Content-Type: application/json" \

  -d '{"message":"What are Thailand business registration requirements?","session_id":"my-session-01"}'

Standard API — 1 USDC (Solana)

curl -X POST https://xrplme.online/wc/v1/thailand/bot-solana \

  -H "Content-Type: application/json" \

  -d '{"message":"What are Thailand business registration requirements?","session_id":"my-session-01"}'

AI Enhanced — 5 XRP (XRPL)

curl -X POST https://xrplme.online/wc/v1/thailand/bot/ai \

  -H "Content-Type: application/json" \

  -d '{"message":"Compare Thailand vs Vietnam for tech startup - which is better and why?","session_id":"my-session-02"}'

AI Enhanced — 7 USDC (Solana)

curl -X POST https://xrplme.online/wc/v1/thailand/bot-solana/ai \

  -H "Content-Type: application/json" \

  -d '{"message":"Compare Thailand vs Vietnam for tech startup - which is better and why?","session_id":"my-session-02"}'

API Docs — Country Agents