# Japan Business Day API – JPX/TSE Trading Day Checker

> Japan Business Day API – JPX/TSE Trading Day Checker is a paid API for AI agents from japan-business-day-api.matchan962.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-12).

Returns whether a given date is a Tokyo Stock Exchange (JPX/TSE) trading day, including closure reasons, and next/previous trading days plus annual daihakkai/dainokai dates.

## Facts

- Endpoint: GET https://japan-business-day-api.matchan962.workers.dev/v1/jpx/trading-day?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/japan-business-day-api-jpx-tse-trading-day-checker-f4e9df7a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_bSHoTtGqfWqcTr5qgOe0h

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 japan-business-day-api-jpx-tse-trading-day-checker-f4e9df7a
```

Example prompt: Is the Tokyo Stock Exchange open on January 15, 2025, and if not, what's the reason it's closed and when is the next trading day?

## When to prefer this

Use this endpoint when you need to verify whether the Tokyo Stock Exchange (JPX/TSE) specifically is open on a given date, get structured closure reasons, or find adjacent trading days. Prefer this over a generic Japanese business day endpoint when financial market calendars (not just national holidays or bank holidays) are what matter — e.g. for trade settlement, equity operations, or market event scheduling.

## Known failure modes

- Missing or invalid 'date' query parameter returns a 400 error
- Date outside supported range may return an error or empty result
- Non-ISO-8601 date format causes a validation failure
- Payment failure (x402) if USDC balance is insufficient

## How this service works

Is the Tokyo Stock Exchange (JPX/TSE) open on a date? Returns closed reasons, next/previous trading day and the first/last trading days of the year (daihakkai/dainokai).

## Output

Returns a JSON object indicating whether the queried date is a JPX/TSE trading day, the reason for any market closure (holiday name, weekend, etc.), the date of the next trading day, the previous trading day, and the annual first (daihakkai) and last (dainokai) trading days of the year.

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/japan-business-day-api-jpx-tse-trading-day-checker-f4e9df7a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from japan-business-day-api.matchan962.workers.dev](https://www.zero.xyz/host/japan-business-day-api.matchan962.workers.dev/llms.txt)
