# Korean Business-Day Calendar Count

> Korean Business-Day Calendar Count is a paid API for AI agents from x402.pokt-agent.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-12).

Counts the number of Korean business days between two dates, returning holidays observed in the range with their Korean names.

## Facts

- Endpoint: GET https://x402.pokt-agent.com/kr-calendar/count?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/korean-business-day-calendar-count-f8ccc280
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_IKNE49Ldr8KyxpqgqgNjM

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 korean-business-day-calendar-count-f8ccc280
```

Example prompt: How many Korean business days are there between September 30 and October 31, 2026, and which public holidays fall in that range?

## When to prefer this

Use this endpoint when you need authoritative South Korean public holiday data and business-day counts for a specific date range — particularly for financial settlement calculations, legal deadline computations, payroll planning, or Korean market trading-day analysis. It is the right choice when Korean-specific holidays (including substitute holidays like 대체공휴일) must be correctly excluded, and when you need the holidays identified by their official Korean names. It is preferable over generic calendar APIs that lack Korean holiday data or over manually maintained holiday lists.

## Known failure modes

- Missing required 'from' or 'to' query parameters returns a validation error
- Invalid date format causes a parsing error
- Date range where 'to' is before 'from' may return 0 business days or an error
- Payment failure via x402/USDC on Base blocks the request before computation
- Extremely large date ranges may hit timeout or unexpected edge cases

## How this service works

Pay-per-call Korean company due diligence, company ID crosswalk, sanctions screening with Korean name variants, Upbit/Bithumb risk events, HWP to Markdown, business status, business-day calendar, address normalisation, law, rates, filings and more. No account or API key: pay each call in USDC on Base via x402.

## Output

Returns a JSON object with the from date, to date, an integer count of business_days in the range, and an array of holidays_in_range where each entry is a date string followed by the Korean holiday name (e.g. '2026-10-03 개천절').

## 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"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "from",
      "to"
     ],
     "properties": {
      "to": {
       "type": "string"
      },
      "from": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "to": "2026-10-31",
  "from": "2026-09-30",
  "business_days": 20,
  "holidays_in_range": [
   "2026-10-03 개천절",
   "2026-10-05 대체공휴일(개천절)",
   "2026-10-09 한글날"
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/korean-business-day-calendar-count-f8ccc280/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.pokt-agent.com](https://www.zero.xyz/host/x402.pokt-agent.com/llms.txt)