# asiaref — Asian government reference data

No account. No API key. No signup. Pay per call with x402.

Clean, cited JSON for Asian government reference values — central-bank
policy rates, VAT, minimum wages, CPI inflation, corporate & personal income tax,
and public holidays across 28 countries. Every response includes the
official source URL, effective date, last_confirmed date and a stale flag.

## If you sell over x402, start here
Making a cross-border digital sale? Before you settle, know who accounts for the VAT:
- POST https://asiaref.dev/v1/vat/determine {seller_country, buyer_country, buyer_type?}
  → place of supply, who accounts for VAT, rate basis, registration trigger — each
    cited to the statute (EU / UK / South Africa). Wallet-only buyer with no tax id →
    treated as B2C and flagged. Out-of-scope country pairs are refused FREE (422),
    never guessed. $0.10/call.

## Sources & licence
Every value is compiled from official government sources — central banks,
finance and labour ministries, revenue authorities, statistical offices — and
each response cites the exact official source URL it was verified against.
Independent service, not affiliated with any government. Verify against the
cited official source before legal or financial use.

## How to call a paid endpoint (x402)
1. Call the endpoint with no payment. You get HTTP 402. The payment challenge is in the
   base64-encoded `payment-required` RESPONSE HEADER (the body is an empty `{}`); decode it to see
   price, asset (USDC), network (eip155:8453 = Base) and pay-to address.
2. Sign the payment with any x402 client — @x402/fetch wraps fetch and does
   steps 1-3 automatically.
3. Retry with the signed X-PAYMENT header. You get HTTP 200 + the data;
   the settlement receipt is returned in the PAYMENT-RESPONSE header.
Bad input is rejected FREE (4xx before the payment gate) — you never pay to fail.
Free, no payment: https://asiaref.dev/catalog · https://asiaref.dev/llms.txt · https://asiaref.dev/openapi.json · public holidays.

## Pricing ladder
- $0.001/call — any single series value, its history, or the change feed
- $0.02 — full regional snapshot (/v1/all) · VAT breakdown · working-days calculator
- $0.05 — minimum-wage compliance check · income-tax computation
- $0.10 — gross-to-net payroll (NG, KE) · cross-border VAT determination · webhook alerts
Licensed tiers / API keys: api@3l-groupconsulting.co.za

## Machine-readable discovery
- x402 resource map: https://asiaref.dev/.well-known/x402.json
- Agent card: https://asiaref.dev/.well-known/agent.json
- OpenAPI: https://asiaref.dev/openapi.json
- MCP server (streamable HTTP): https://asiaref.dev/mcp — tools: list_series, get_public_holidays (free); get_series, get_series_history, get_snapshot (paid via x402 or api_key)

## Series
- GET /v1/ae/policy-rate — United Arab Emirates: CBUAE Base Rate (Overnight Deposit Facility)
- GET /v1/ae/vat — United Arab Emirates: VAT standard rate
- GET /v1/ae/minimum-wage — United Arab Emirates: Statutory minimum wage
- GET /v1/ae/public-holidays — United Arab Emirates: Public holidays (free)
- GET /v1/ae/cpi — United Arab Emirates: CPI inflation (year-on-year)
- GET /v1/ae/corporate-tax — United Arab Emirates: Corporate Tax (headline rate)
- GET /v1/ae/income-tax — United Arab Emirates: Personal income tax
- GET /v1/bd/policy-rate — Bangladesh: Policy Rate (Repo)
- GET /v1/bd/vat — Bangladesh: Value Added Tax (standard rate)
- GET /v1/bd/minimum-wage — Bangladesh: Minimum Wage
- GET /v1/bd/public-holidays — Bangladesh: Public Holidays (free)
- GET /v1/bd/cpi — Bangladesh: Consumer Price Inflation
- GET /v1/bd/corporate-tax — Bangladesh: Corporate Income Tax (standard rate)
- GET /v1/bd/income-tax — Bangladesh: Personal Income Tax (progressive bands)
- GET /v1/bh/policy-rate — Bahrain: CBB Key Policy Rate — one-week deposit rate
- GET /v1/bh/vat — Bahrain: Value-added tax (VAT) — standard rate
- GET /v1/bh/minimum-wage — Bahrain: Statutory national minimum wage
- GET /v1/bh/public-holidays — Bahrain: Official public holidays (free)
- GET /v1/bh/cpi — Bahrain: Consumer Price Index (latest month)
- GET /v1/bh/corporate-tax — Bahrain: General corporate income tax rate
- GET /v1/bh/income-tax — Bahrain: Personal income tax
- GET /v1/cn/policy-rate — China: PBoC 7-day reverse repo operation rate (主要政策利率)
- GET /v1/cn/vat — China: VAT standard rate (增值税基本税率)
- GET /v1/cn/minimum-wage — China: Minimum wage (no national rate — province-set; highest is Shanghai)
- GET /v1/cn/public-holidays — China: Public holidays (国家法定节假日 + State Council annual arrangement) (free)
- GET /v1/cn/cpi — China: CPI inflation (year-on-year, 居民消费价格指数)
- GET /v1/cn/corporate-tax — China: Enterprise Income Tax standard rate (企业所得税)
- GET /v1/cn/income-tax — China: Individual Income Tax — comprehensive-income brackets (个人所得税)
- GET /v1/hk/policy-rate — Hong Kong: HKMA Base Rate
- GET /v1/hk/vat — Hong Kong: Value-added tax / GST
- GET /v1/hk/minimum-wage — Hong Kong: Statutory Minimum Wage (SMW)
- GET /v1/hk/public-holidays — Hong Kong: General holidays (free)
- GET /v1/hk/cpi — Hong Kong: Composite CPI inflation (year-on-year)
- GET /v1/hk/corporate-tax — Hong Kong: Profits Tax rate (corporations)
- GET /v1/hk/income-tax — Hong Kong: Salaries Tax (progressive rates)
- GET /v1/id/policy-rate — Indonesia: Policy Rate (BI-Rate)
- GET /v1/id/vat — Indonesia: Value Added Tax (Pajak Pertambahan Nilai, PPN)
- GET /v1/id/minimum-wage — Indonesia: Minimum Wage (Upah Minimum)
- GET /v1/id/public-holidays — Indonesia: Public Holidays (Hari Libur Nasional) (free)
- GET /v1/id/cpi — Indonesia: Consumer Price Index Inflation (Inflasi IHK)
- GET /v1/id/corporate-tax — Indonesia: Corporate Income Tax (Pajak Penghasilan Badan)
- GET /v1/id/income-tax — Indonesia: Personal Income Tax (Pajak Penghasilan Orang Pribadi, PPh OP)
- GET /v1/il/policy-rate — Israel: Bank of Israel interest rate
- GET /v1/il/vat — Israel: VAT standard rate (מס ערך מוסף)
- GET /v1/il/minimum-wage — Israel: National minimum wage
- GET /v1/il/public-holidays — Israel: Public holidays (free)
- GET /v1/il/cpi — Israel: CPI inflation (year-on-year)
- GET /v1/il/corporate-tax — Israel: Corporate income tax rate
- GET /v1/il/income-tax — Israel: Personal income tax brackets
- GET /v1/in/policy-rate — India: RBI policy repo rate
- GET /v1/in/vat — India: GST standard rate
- GET /v1/in/minimum-wage — India: Minimum wage
- GET /v1/in/public-holidays — India: Public holidays (free)
- GET /v1/in/cpi — India: CPI inflation (year-on-year)
- GET /v1/in/corporate-tax — India: Corporate income tax rate
- GET /v1/in/income-tax — India: Personal income tax bands
- GET /v1/iq/policy-rate — Iraq: CBI Policy Rate (سعر السياسة النقدية)
- GET /v1/iq/vat — Iraq: Value-added tax (VAT)
- GET /v1/iq/minimum-wage — Iraq: National minimum wage (الحد الأدنى للأجور)
- GET /v1/iq/public-holidays — Iraq: Public holidays (free)
- GET /v1/iq/cpi — Iraq: Consumer Price Index (latest month)
- GET /v1/iq/corporate-tax — Iraq: Corporate income tax rate
- GET /v1/iq/income-tax — Iraq: Personal income tax (progressive bands)
- GET /v1/jo/policy-rate — Jordan: CBJ Main Policy Rate (سعر الفائدة الرئيسي للبنك المركزي)
- GET /v1/jo/vat — Jordan: General Sales Tax (GST) — standard rate
- GET /v1/jo/minimum-wage — Jordan: National minimum wage (الحد الأدنى للأجور)
- GET /v1/jo/public-holidays — Jordan: Public holidays 2026 (free)
- GET /v1/jo/cpi — Jordan: Consumer Price Index (latest month)
- GET /v1/jo/corporate-tax — Jordan: Corporate income tax rate (legal persons) — general rate
- GET /v1/jo/income-tax — Jordan: Personal income tax brackets (natural persons)
- GET /v1/jp/policy-rate — Japan: Bank of Japan policy rate (uncollateralized overnight call rate target)
- GET /v1/jp/vat — Japan: Consumption tax (standard rate)
- GET /v1/jp/minimum-wage — Japan: Minimum wage (lowest prefectural regional minimum wage)
- GET /v1/jp/public-holidays — Japan: Public holidays (free)
- GET /v1/jp/cpi — Japan: Consumer price inflation (CPI, all items, year-on-year)
- GET /v1/jp/corporate-tax — Japan: Corporate income tax (national corporation tax, standard rate)
- GET /v1/jp/income-tax — Japan: Personal income tax (national, progressive bands)
- GET /v1/kr/policy-rate — South Korea: Bank of Korea Base Rate
- GET /v1/kr/vat — South Korea: Value-Added Tax (부가가치세) standard rate
- GET /v1/kr/minimum-wage — South Korea: National minimum wage (최저임금)
- GET /v1/kr/public-holidays — South Korea: Public holidays (free)
- GET /v1/kr/cpi — South Korea: Consumer price inflation (소비자물가 상승률)
- GET /v1/kr/corporate-tax — South Korea: Corporate income tax (법인세) top rate
- GET /v1/kr/income-tax — South Korea: Personal income tax (종합소득세) schedule
- GET /v1/kw/policy-rate — Kuwait: CBK Discount Rate
- GET /v1/kw/vat — Kuwait: Value-added tax (VAT)
- GET /v1/kw/minimum-wage — Kuwait: National minimum wage (private and oil sector)
- GET /v1/kw/public-holidays — Kuwait: Public holidays (free)
- GET /v1/kw/cpi — Kuwait: Consumer Price Index (latest month)
- GET /v1/kw/corporate-tax — Kuwait: Corporate income tax rate (foreign-owned share)
- GET /v1/kw/income-tax — Kuwait: Personal income tax
- GET /v1/kz/policy-rate — Kazakhstan: NBK base rate (базовая ставка)
- GET /v1/kz/vat — Kazakhstan: VAT standard rate (НДС)
- GET /v1/kz/minimum-wage — Kazakhstan: Minimum monthly wage (МЗП)
- GET /v1/kz/public-holidays — Kazakhstan: Public holidays (free)
- GET /v1/kz/cpi — Kazakhstan: CPI inflation (year-on-year)
- GET /v1/kz/corporate-tax — Kazakhstan: Corporate income tax standard rate (КПН)
- GET /v1/kz/income-tax — Kazakhstan: Personal income tax rates (ИПН)
- GET /v1/lk/policy-rate — Sri Lanka: Overnight Policy Rate (OPR)
- GET /v1/lk/vat — Sri Lanka: VAT standard rate
- GET /v1/lk/minimum-wage — Sri Lanka: National minimum wage
- GET /v1/lk/public-holidays — Sri Lanka: Public holidays (free)
- GET /v1/lk/cpi — Sri Lanka: CCPI inflation (year-on-year)
- GET /v1/lk/corporate-tax — Sri Lanka: Corporate income tax standard rate
- GET /v1/lk/income-tax — Sri Lanka: Personal income tax bands
- GET /v1/my/policy-rate — Malaysia: Overnight Policy Rate (OPR)
- GET /v1/my/vat — Malaysia: Value Added Tax
- GET /v1/my/minimum-wage — Malaysia: National Minimum Wage
- GET /v1/my/public-holidays — Malaysia: Public Holidays (free)
- GET /v1/my/cpi — Malaysia: Consumer Price Index (annual inflation)
- GET /v1/my/corporate-tax — Malaysia: Corporate Income Tax
- GET /v1/my/income-tax — Malaysia: Personal Income Tax
- GET /v1/np/policy-rate — Nepal: NRB policy rate (fixed repo rate)
- GET /v1/np/vat — Nepal: VAT standard rate
- GET /v1/np/minimum-wage — Nepal: National minimum remuneration
- GET /v1/np/public-holidays — Nepal: Public holidays (free)
- GET /v1/np/cpi — Nepal: Consumer price inflation (year-on-year)
- GET /v1/np/corporate-tax — Nepal: Corporate income tax standard rate
- GET /v1/np/income-tax — Nepal: Personal income tax bands
- GET /v1/om/policy-rate — Oman: CBO Repo Rate (interest rate on repurchase operations with the Central Bank of Oman)
- GET /v1/om/vat — Oman: Value Added Tax (VAT) — standard rate
- GET /v1/om/minimum-wage — Oman: Minimum wage for Omani nationals in the private sector
- GET /v1/om/public-holidays — Oman: Official public holidays (free)
- GET /v1/om/cpi — Oman: Consumer Price Index — annual inflation rate (latest month)
- GET /v1/om/corporate-tax — Oman: Corporate income tax — standard rate
- GET /v1/om/income-tax — Oman: Personal income tax
- GET /v1/ph/policy-rate — Philippines: BSP Target Reverse Repurchase (RRP) Rate
- GET /v1/ph/vat — Philippines: Value-Added Tax (standard rate)
- GET /v1/ph/minimum-wage — Philippines: Minimum Wage (lowest regional non-agriculture daily floor)
- GET /v1/ph/public-holidays — Philippines: Public Holidays 2026 (free)
- GET /v1/ph/cpi — Philippines: Consumer Price Inflation (headline, y/y)
- GET /v1/ph/corporate-tax — Philippines: Corporate Income Tax (regular rate)
- GET /v1/ph/income-tax — Philippines: Personal Income Tax (graduated schedule)
- GET /v1/pk/policy-rate — Pakistan: SBP Policy (Target) Rate
- GET /v1/pk/vat — Pakistan: General Sales Tax (GST) — federal standard rate on goods
- GET /v1/pk/minimum-wage — Pakistan: Minimum wage (unskilled worker, monthly)
- GET /v1/pk/public-holidays — Pakistan: Public holidays (free)
- GET /v1/pk/cpi — Pakistan: CPI inflation (year-on-year)
- GET /v1/pk/corporate-tax — Pakistan: Corporate income tax rate
- GET /v1/pk/income-tax — Pakistan: Personal income tax brackets — SALARIED individuals
- GET /v1/qa/policy-rate — Qatar: QCB Deposit Rate (QCBDR)
- GET /v1/qa/vat — Qatar: Value-added tax (VAT)
- GET /v1/qa/minimum-wage — Qatar: National non-discriminatory minimum wage
- GET /v1/qa/public-holidays — Qatar: Public holidays (free)
- GET /v1/qa/cpi — Qatar: Consumer Price Index (latest month)
- GET /v1/qa/corporate-tax — Qatar: Corporate income tax rate
- GET /v1/qa/income-tax — Qatar: Personal income tax
- GET /v1/sa/policy-rate — Saudi Arabia: SAMA Repo Rate
- GET /v1/sa/vat — Saudi Arabia: Value Added Tax (standard rate)
- GET /v1/sa/minimum-wage — Saudi Arabia: Minimum wage for Saudi nationals (Saudization / Nitaqat)
- GET /v1/sa/public-holidays — Saudi Arabia: Public holidays (free)
- GET /v1/sa/cpi — Saudi Arabia: Consumer Price Index inflation (year-on-year)
- GET /v1/sa/corporate-tax — Saudi Arabia: Corporate income tax rate
- GET /v1/sa/income-tax — Saudi Arabia: Personal income tax
- GET /v1/sg/policy-rate — Singapore: Policy interest rate
- GET /v1/sg/vat — Singapore: GST standard rate
- GET /v1/sg/minimum-wage — Singapore: Statutory minimum wage
- GET /v1/sg/public-holidays — Singapore: Public holidays (free)
- GET /v1/sg/cpi — Singapore: Consumer price inflation (CPI, year-on-year)
- GET /v1/sg/corporate-tax — Singapore: Corporate income tax rate
- GET /v1/sg/income-tax — Singapore: Personal income tax (resident rates)
- GET /v1/th/policy-rate — Thailand: Policy interest rate
- GET /v1/th/vat — Thailand: Value added tax (standard rate)
- GET /v1/th/minimum-wage — Thailand: Minimum wage
- GET /v1/th/public-holidays — Thailand: Public holidays (free)
- GET /v1/th/cpi — Thailand: Consumer price index / inflation
- GET /v1/th/corporate-tax — Thailand: Corporate income tax (standard rate)
- GET /v1/th/income-tax — Thailand: Personal income tax (progressive bands)
- GET /v1/tr/policy-rate — Türkiye: CBRT one-week repo auction rate (bir hafta vadeli repo ihale faiz oranı)
- GET /v1/tr/vat — Türkiye: KDV standard rate (genel katma değer vergisi oranı)
- GET /v1/tr/minimum-wage — Türkiye: Asgari ücret (national minimum wage, gross monthly)
- GET /v1/tr/public-holidays — Türkiye: Ulusal bayram ve genel tatil günleri 2026 (free)
- GET /v1/tr/cpi — Türkiye: TÜFE consumer price inflation (year-on-year)
- GET /v1/tr/corporate-tax — Türkiye: Kurumlar vergisi standard rate
- GET /v1/tr/income-tax — Türkiye: Gelir vergisi tarifesi (personal income tax brackets)
- GET /v1/tw/policy-rate — Taiwan: CBC discount rate (重貼現率)
- GET /v1/tw/vat — Taiwan: Business tax (VAT) standard rate — 加值型營業稅
- GET /v1/tw/minimum-wage — Taiwan: Minimum Wage (最低工資) — monthly and hourly
- GET /v1/tw/public-holidays — Taiwan: Public holidays (free)
- GET /v1/tw/cpi — Taiwan: CPI inflation (year-on-year)
- GET /v1/tw/corporate-tax — Taiwan: Profit-seeking enterprise income tax rate
- GET /v1/tw/income-tax — Taiwan: Individual consolidated income tax brackets
- GET /v1/uz/policy-rate — Uzbekistan: CBU policy rate (asosiy stavka / основная ставка)
- GET /v1/uz/vat — Uzbekistan: VAT standard rate (НДС / QQS)
- GET /v1/uz/minimum-wage — Uzbekistan: Minimum wage (eng kam ish haqi / минимальный размер оплаты труда, МРОТ)
- GET /v1/uz/public-holidays — Uzbekistan: Public holidays (free)
- GET /v1/uz/cpi — Uzbekistan: CPI inflation (year-on-year)
- GET /v1/uz/corporate-tax — Uzbekistan: Corporate profit tax standard rate (налог на прибыль)
- GET /v1/uz/income-tax — Uzbekistan: Individual income tax rate (НДФЛ / jismoniy shaxslardan olinadigan daromad solig'i)
- GET /v1/vn/policy-rate — Vietnam: Policy rate
- GET /v1/vn/vat — Vietnam: Value added tax (Thue gia tri gia tang)
- GET /v1/vn/minimum-wage — Vietnam: Minimum wage (Muc luong toi thieu vung)
- GET /v1/vn/public-holidays — Vietnam: Public holidays (free)
- GET /v1/vn/cpi — Vietnam: Consumer price index (Chi so gia tieu dung)
- GET /v1/vn/corporate-tax — Vietnam: Corporate income tax (Thue thu nhap doanh nghiep)
- GET /v1/vn/income-tax — Vietnam: Personal income tax (Thue thu nhap ca nhan)

History: GET /v1/{country}/{series}/history?from=YYYY-MM-DD&to=YYYY-MM-DD — e.g. GET /v1/ae/policy-rate/history?from=2026-01-01
Changes + freshness (FREE, unmetered): GET /v1/changes?since=YYYY-MM-DD — what changed, plus how many of our 196 series were re-verified against their official source in the last 1/7/30/90 days, and which one has gone longest without a check. `since` is optional (defaults to 30 days).

## Answers (computed verdicts, POST JSON)
- POST /v1/answers/wage-check {country, amount, period, schedule?} — at/above/below the statutory minimum? Pass "schedule" to be measured against a sectoral/zonal/grade floor instead of the general one (Kenya 55, South Africa 24); omit it and we say so, because "above the national floor" is not "compliant". Keys: GET /catalog ($0.05)
- POST /v1/answers/vat {country, amount, mode?, band?} — net/tax/gross breakdown incl. levy components. Pass "band" for a statutory reduced/zero/super-reduced rate; we publish what each band covers in the authority's own words but do not classify supplies into bands. Keys: GET /catalog ($0.02)
- POST /v1/answers/working-days {country, from, to} — working days, holidays hit, next working day ($0.02)
- POST /v1/answers/income-tax {country, taxable_income} — statutory income tax + per-bracket workings ($0.05)
- POST /v1/answers/settlement-date {trade_date, calendars[], business_days | market + instrument_class} — settlement/value date: T+n business days across one or more national statutory calendars intersected, with a per-day trail, each calendar's basis and source, and the market cycle cited to its primary instrument where we hold one ($0.05). Cited cycles and what we deliberately refuse to cite: GET /settlement-conventions (free)
- POST /v1/vat/determine {seller_country, buyer_country, buyer_type?} — cross-border VAT treatment of a digital-services sale: place of supply, who accounts, rate basis, registration trigger, with the applied rule cited to the statute. EU, UK, South Africa; unknown buyer → B2C-default, flagged; out-of-scope pairs refused FREE (422), never guessed, never charged ($0.10)