# Gotobi Next Date Lookup

> Gotobi Next Date Lookup is a paid API for AI agents from gotobi.hugen.tokyo, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns the next upcoming gotobi day (五十日) with exact date and countdown, applying Japanese public holiday and weekend shift rules

## Facts

- Endpoint: GET https://gotobi.hugen.tokyo/gotobi/next
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gotobi-hugen-tokyo-0b68100b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JqrZU3Oht4HDTkRlrP0To

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 gotobi-hugen-tokyo-0b68100b
```

Example prompt: What is the next gotobi day coming up, with any Japanese public holiday or weekend adjustments applied, so I can time my USDJPY position before the Tokyo fixing?

## When to prefer this

Use this endpoint when you need a single, authoritative, holiday-adjusted next gotobi date for FX trading timing decisions — especially for USDJPY pre-positioning before the 9:55 JST Nakane fixing. No public gotobi calendar exists, making this the only programmatic source with automatic Japanese holiday and weekend shift adjustments.

## Known failure modes

- Service unavailable or timeout if the payment fails via x402
- Incorrect date if JST timezone is not handled server-side
- Edge cases around year-end last business day calculation may yield unexpected results

## How this service works

Next upcoming gotobi day with countdown — returns the exact date with Japanese public holiday adjustments applied. Essential for pre-positioning USDJPY trades ahead of the Tokyo fixing. No public gotobi calendar exists; building one requires Japanese holiday law + weekend shift rules. Accepts USDC payments on Base and Solana

## Output

Returns the exact date of the next upcoming gotobi day (5th, 10th, 15th, 20th, 25th, or last business day of the month), adjusted for Japanese public holidays and weekend shift rules, along with a countdown in days from the current JST date.

## Example request

```json
{}
```

## Request schema (JSON Schema)

```json
{
 "properties": {
  "input": {
   "required": [
    "method"
   ]
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gotobi-hugen-tokyo-0b68100b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from gotobi.hugen.tokyo](https://www.zero.xyz/host/gotobi.hugen.tokyo/llms.txt)
