Thai Reference API

$0.005 / call x402 - USDC - Base Sepolia no API key needed

Thailand reference data for AI agents & developers. Pay per request with x402 (HTTP 402) — no signup, no subscription, no API key. Base URL: https://api.thaical.xyz

Quickstart (30 seconds)

curl -i https://api.thaical.xyz/fx
# -> HTTP 402 + PAYMENT-REQUIRED header (the terms: amount, asset, payTo)
# Retry with the x402 payment header (any x402 client SDK does this automatically):
#   PAYMENT-SIGNATURE: <signed EIP-3009 payment>
# -> HTTP 200 + JSON data

Client SDKs: x402 Python/TS SDK. Payer only needs USDC on Base (EIP-3009 — the payer pays no gas).

Endpoints

EndpointReturns
/fxTHB reference FX (USD/EUR/JPY/GBP/CNY to THB), ECB daily, cached 1h
/goldThai gold: XAU spot USD/THB + 96.5% per baht-weight estimate (spot-derived, labeled)
/is-business-day?date=YYYY-MM-DDThai business-day check incl. holiday names & substitution days
/bank-business-day?date=YYYY-MM-DDBank-of-Thailand business-day convention (settlement dates)
/add-business-days?date=YYYY-MM-DD&n=5Add N Thai business days (skips Thai holidays)

Terms (machine-readable)

Every unpaid request receives an HTTP 402 whose PAYMENT-REQUIRED header carries the full payment terms (x402 v2): scheme exact, asset USDC, network eip155:84532, amount 5000 (0.005 USDC), maxTimeout 300s. Settlement via Coinbase CDP facilitator.

Honesty notes

MCP wrapper

An MCP server wrapping all endpoints (thai_fx, thai_gold, thai_is_business_day, thai_add_business_days) with automatic x402 payment: mozzquito/thai-ref-x402

Testnet (Base Sepolia) — production chain coming. Built with the official x402 Python SDK.