# asiaref - Asian Government Reference Data History

> asiaref - Asian Government Reference Data History is a paid API for AI agents from asiaref.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-13).

Returns the historical time-series of a specific government reference data series (e.g. policy rate, VAT, CPI) for a given Asian country

## Facts

- Endpoint: GET https://asiaref.dev/v1/:country/:series/history
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/asiaref-asian-government-reference-data-history-539a44c2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rRrDkLfpB065_QVzFldKh

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability asiaref-asian-government-reference-data-history-539a44c2
```

Example prompt: What's the historical policy rate series for Japan from asiaref — pull the full history for the jp policy-rate series.

## When to prefer this

Use this endpoint when you need historical time-series data for government-mandated reference figures (tax rates, interest rates, wages, CPI, public holidays) specifically for Asian countries covered (Bangladesh, Indonesia, India, Japan, South Korea, Malaysia, Philippines, Singapore, Thailand, Vietnam). Prefer this over general web search when you need structured, machine-readable data with source attribution and staleness signals.

## Known failure modes

- Invalid country code not in enum [bd,id,in,jp,kr,my,ph,sg,th,vn] — likely 400 or 404 response
- Invalid series identifier not in enum [policy-rate,vat,minimum-wage,public-holidays,cpi,corporate-tax,income-tax] — likely 400 or 404 response
- Stale flag set to true when data is past expected update cycle — data returned but may be outdated
- Payment required / 402 response if x402 payment header is missing or insufficient
- Data temporarily unavailable for a specific country-series combination — 404 or empty response

## How this service works

Government reference data series

## Output

Returns a structured object with the country code, series identifier, current value, effective_from date, last_confirmed date, staleness flag, source name and URL, optional unit, optional notes, optional components array (for composite rates), and optional effective_rate. For public holiday series, value is an array of {date, name} objects.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "country",
      "series"
     ],
     "properties": {
      "series": {
       "enum": [
        "policy-rate",
        "vat",
        "vat-registration-threshold",
        "minimum-wage",
        "public-holidays",
        "cpi",
        "corporate-tax",
        "withholding-tax",
        "statutory-interest",
        "income-tax",
        "social-contributions",
        "fx-reference"
       ],
       "type": "string",
       "description": "Reference series id"
      },
      "country": {
       "enum": [
        "ae",
        "bd",
        "bh",
        "cn",
        "hk",
        "id",
        "il",
        "in",
        "iq",
        "jo",
        "jp",
        "kr",
        "kw",
        "kz",
        "lk",
        "my",
        "np",
        "om",
        "ph",
        "pk",
        "qa",
        "sa",
        "sg",
        "th",
        "tr",
        "tw",
        "uz",
        "vn"
       ],
       "type": "string",
       "description": "ISO country code"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {},
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/asiaref-asian-government-reference-data-history-539a44c2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from asiaref.dev](https://www.zero.xyz/host/asiaref.dev/llms.txt)