Product Tiers

Two tiers of API access — Standard queries for focused questions, AI-enhanced for deeper analysis.

Product tiers

We offer two tiers of API access:

Standard
0.1 XRP
AI Enhanced
0.5 XRP

Standard queries

Price: 0.1 XRP per query

Standard queries are for focused, single-country questions that can be answered from structured data and rules.

  • Examples:
  • "What is the corporate income tax rate in Thailand?"
  • "What are the work permit requirements for foreigners in Vietnam?"
  • "What is the withholding tax on dividends paid to non-residents in Japan?"
  • Characteristics:
  • Lower price tier.
  • Fast, deterministic answers based on verified data sources.
  • Ideal for lookups, fact-checking, and rule-based questions.

AI-enhanced queries

Price: 0.5 XRP per query

AI-enhanced queries go beyond simple lookups. They synthesize information across sources and produce deeper analysis.

  • Examples:
  • "Compare tax incentives for foreign investors in Thailand vs. Vietnam."
  • "What are the regulatory risks for a Japanese company entering the Indian market?"
  • "Summarize recent changes to UAE foreign ownership rules."
  • Characteristics:
  • Higher price tier.
  • LLM-synthesized analysis with source citations.
  • Longer processing time (a few seconds) as the model reasons across sources.
  • Rate-limited (1 request per minute) to ensure quality.

How to use

Both tiers use the same pay-per-query flow. The only difference is which endpoint you call.

Step 1 — Choose your endpoint

  1. Standard: POST to /wc/v1/{country}/bot
  2. AI Enhanced: POST to /wc/v1/{country}/bot/ai

Step 2 — Send your request

  1. Send a POST request with JSON body:
    2. {"message": "Your question here", "session_id": "unique-session-id"}
  2. Include Content-Type: application/json header.

Step 3 — Receive the 402 response

  1. If the request is valid, the server returns HTTP 402 Payment Required.
  2. Response body contains JSON with accepts[0].amount (in drops).
  3. Standard: 100000 drops (0.1 XRP). AI Enhanced: 500000 drops (0.5 XRP).

Step 4 — Pay the invoice

  1. Pay the x402 invoice on the XRP Ledger using a connected wallet.
  2. Include the X-INV-ID header from the 402 response.
  3. The server validates payment and returns HTTP 200 with the answer.

Country coverage

  1. Standard and AI endpoints are available for all 19 supported countries:
    2. thailand, vietnam, japan, korea, usa, canada, uae, uk, philippines, singapore, australia, germany, france, brazil, mexico, switzerland, netherlands, hong_kong, india