# asiaref Webhook Alert Registration

> asiaref Webhook Alert Registration is a paid API for AI agents from asiaref.dev, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-15).

Registers a webhook endpoint to receive real-time notifications when Asian government reference data series (policy rates, VAT, wages, holidays) change

## Facts

- Endpoint: POST https://asiaref.dev/alerts
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/asiaref-webhook-alert-registration-4d01d8fa
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_riP2WP5MIMFvnl_gUjO0U

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-webhook-alert-registration-4d01d8fa -d '<json body>'
```

Example prompt: Set up a webhook to notify my endpoint at https://app.mycompany.com/hooks/asiaref whenever Japan's policy rate or India's VAT rate changes on asiaref.

## When to prefer this

Use this endpoint when you need proactive, event-driven notifications about changes to Asian government reference data rather than polling. Ideal for compliance systems, financial applications, or data pipelines that must react immediately when central bank rates, VAT rates, minimum wages, or public holidays are officially updated. Prefer this over the read endpoints when latency of data propagation matters and you want push rather than pull semantics.

## Known failure modes

- Invalid or unreachable webhook URL returns a 4xx error
- Malformed series pattern strings cause validation errors
- Missing required url field results in 400 Bad Request
- Duplicate subscriptions to the same URL/series combination may return a conflict or create duplicates
- Payment failure (x402) returns 402 Payment Required before subscription is created
- Webhook URL not publicly accessible may cause silent delivery failures later

## How this service works

Authoritative Asian government reference values as clean JSON: central-bank policy rates, VAT rates, national minimum wages and public holidays for India (in), Japan (jp), South Korea (kr), Philippines (ph), Singapore (sg). Every value carries a citation to its official primary source (government gazette or central-bank statement), an effective date, a last-confirmed date and a staleness flag.

## Output

Returns a JSON object with a unique subscription ID (UUID), the registered webhook URL, an active boolean, a hex-encoded HMAC secret for verifying incoming webhook payloads, the list of subscribed series patterns, and the creation timestamp. The HMAC secret should be stored securely to authenticate future series.changed events.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "format": "uri",
   "description": "Webhook endpoint for series.changed events"
  },
  "series": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Patterns like \"ae/policy-rate\", \"bd/*\", or \"*\""
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "id": "3f6a1c2e-0000-4000-8000-000000000000",
  "url": "https://example.com/webhook",
  "active": true,
  "secret": "hex-encoded-hmac-secret",
  "series": [
   "in/policy-rate"
  ],
  "created": "2026-07-15T12:00:00.000Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/asiaref-webhook-alert-registration-4d01d8fa/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)