← Back to xrplme.online

API Docs — Country Agents

Test any country agent endpoint. Pay-per-query via x402 in XRP Ledger or Solana USDC. No API keys, no KYC.

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.

Endpoint tester

Select a country, payment rail, and endpoint type, type your query, and pay to get results.
XRP 1 XRP/ 5 XRP
USDC $1.00 / $7.00
Standard
Factual Data, Fast
AI Enhanced
Smart Analysis
POST https://xrplme.online/wc/v1/hong_kong/bot
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"}'