Api Endpoint

Japan Business Day API

Find auspicious dates in Japan: list days in a range (up to 366 days) matching rokuyo (e.g. taian) and optional weekdays (e.g. sat,sun) - for scheduling weddings, moving, contract signing and ceremonies. 日本の大安など六曜に該当する日付を検索。

Open interactive test console

Offering

Provider
japan-business-day-api.matchan962.workers.dev
Method
GET
Offering type
Api Endpoint
Transport type
http
Category
General Utilities
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://japan-business-day-api.matchan962.workers.dev/v1/koyomi/find
MIME type
application/json
First seen
2026-10-16T01:50:38.788Z
Last seen
Tags
japan, business-day, holiday, fintech, logistics

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.01 USDC
Atomic price: 10000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Payment option 2
0.01 USDC
Atomic price: 10000 · Network: eip155:137 · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "10000",
    "payTo": "0x1d813e4e4C7B0ae7900a6d2b6bcA560941102859"
  },
  {
    "scheme": "exact",
    "network": "eip155:137",
    "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
    "amount": "10000",
    "payTo": "0x1d813e4e4C7B0ae7900a6d2b6bcA560941102859"
  }
]

Observed health

Status
Healthy
Latest latency
1324 ms
Average latency
1290 ms
HTTP status
402
Last checked
Reachability
100% over 14 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "const": "http"
    },
    "method": {
      "type": "string",
      "enum": [
        "GET"
      ]
    },
    "queryParams": {
      "type": "object",
      "properties": {
        "from": {
          "type": "string",
          "format": "date"
        },
        "to": {
          "type": "string",
          "format": "date"
        },
        "rokuyo": {
          "type": "string",
          "description": "Comma-separated: taian,shakko,sensho,tomobiki,sakimake,butsumetsu (default taian)"
        },
        "weekdays": {
          "type": "string",
          "description": "Optional comma-separated weekdays, e.g. sat,sun"
        }
      },
      "required": [
        "from",
        "to"
      ]
    }
  },
  "required": [
    "type",
    "method"
  ],
  "additionalProperties": false
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "method": {
          "enum": [
            "GET"
          ],
          "type": "string"
        },
        "queryParams": {
          "properties": {
            "from": {
              "format": "date",
              "type": "string"
            },
            "rokuyo": {
              "description": "Comma-separated: taian,shakko,sensho,tomobiki,sakimake,butsumetsu (default taian)",
              "type": "string"
            },
            "to": {
              "format": "date",
              "type": "string"
            },
            "weekdays": {
              "description": "Optional comma-separated weekdays, e.g. sat,sun",
              "type": "string"
            }
          },
          "required": [
            "from",
            "to"
          ],
          "type": "object"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}