# lltcore Market Clock

> Free, keyless, read-only API and MCP server with the exact time and the trading context agents usually lack: which trading sessions are active, whether US equities, London, Xetra, CME crypto, forex or crypto markets are open (holidays and early closes included), when the current candle closes, when perpetual funding settles on Binance, Bybit, OKX and Hyperliquid, when Deribit, Binance and CME Bitcoin contracts expire, and when the next FOMC decision is. Times only, no prices. Not financial advice.

Every endpoint accepts `at` (ISO 8601 or unix time) to compute for any past or future moment. Responses are JSON. CORS is open.

## MCP

- Endpoint: https://api.lltcore.com/mcp (Streamable HTTP, stateless, JSON responses)
- Claude Code: `claude mcp add --transport http market-clock https://api.lltcore.com/mcp`
- Tools: market_clock, get_time, convert_time, candle_bounds, trading_sessions, funding_times, market_status, market_calendar, derivatives_expiries, macro_events

## REST

- [/v1/clock](https://api.lltcore.com/v1/clock): everything at once
- [/v1/time?tz=Europe/Berlin](https://api.lltcore.com/v1/time?tz=Europe/Berlin): exact time, also in a time zone
- [/v1/convert?time=2026-11-17T09:30&from=America/New_York&to=Asia/Tokyo](https://api.lltcore.com/v1/convert?time=2026-11-17T09:30&from=America/New_York&to=Asia/Tokyo): wall-clock conversion
- [/v1/candle?tf=4h](https://api.lltcore.com/v1/candle?tf=4h): current 4h candle: open, close, seconds left
- [/v1/sessions](https://api.lltcore.com/v1/sessions): Sydney / Tokyo / London / New York, overlaps
- [/v1/funding](https://api.lltcore.com/v1/funding): next funding on Binance, Bybit, OKX, Hyperliquid
- [/v1/markets/us_equities](https://api.lltcore.com/v1/markets/us_equities): is the US stock market open? next open/close
- [/v1/calendar/us_equities/2027](https://api.lltcore.com/v1/calendar/us_equities/2027): holidays and early closes
- [/v1/expiries](https://api.lltcore.com/v1/expiries): Deribit, Binance quarterly, CME Bitcoin futures
- [/v1/events](https://api.lltcore.com/v1/events): next FOMC decisions
- [/v1/clock?at=2026-08-17T11:00:00Z](https://api.lltcore.com/v1/clock?at=2026-08-17T11:00:00Z): any moment, past or future

## worldtimeapi.org-compatible

Same JSON fields as worldtimeapi.org, for scripts that used it:

- [https://api.lltcore.com/api/timezone/Europe/Berlin](https://api.lltcore.com/api/timezone/Europe/Berlin) (append .txt for plain text)
- [https://api.lltcore.com/api/ip](https://api.lltcore.com/api/ip): time in the caller's own time zone
- [https://api.lltcore.com/api/timezone](https://api.lltcore.com/api/timezone): all zone names

## Reference

- [OpenAPI 3.1](https://api.lltcore.com/openapi.json)
- [Tool list](https://api.lltcore.com/v1/tools)

## About

Part of AGAINST THE MACHINE (https://lltcore.com): for 16 months, ten copies of DeepSeek-R1 voted on Bitcoin every hour, and a bot bet against them whenever all ten agreed. The `live3_label` field in /v1/sessions is the exact session label that bot sent to the model with every candle.

## Sources and limits

- US equity holidays 2026-2028: nyse.com. London holidays 2026-2027: gov.uk. Xetra: standing holiday rule (2026 checked). FOMC: federalreserve.gov. Funding and expiry conventions: checked against each venue's public API on 2026-11-17.
- Outside the covered years the API says so in `calendar_warning` and assumes weekday hours.
- Unscheduled closures (national days of mourning, outages) cannot be known in advance.
