REST API · v1

Market hours, as data your code can read.

TradeTi.me tracks when the world's stock exchanges are open. This API hands you that knowledge as plain JSON — is a market open right now, when does it next open, what are its holidays and hours — for 30 exchanges. It's free, needs no signup, and works straight from a browser.

What can you build with it?

• A market clock or world-markets dashboard that shows what's trading right now.
• A schedule gate for a bot — only act while the exchange is actually open.
• An alert — "tell me 10 minutes before Tokyo opens."
• A calendar that knows the market holidays and half-days.

If you'd rather your AI assistant answer these questions directly, there's an MCP server — same data, built for agents. This page is the API for your own code.

Your first request

Every request is an ordinary web address (a URL) that returns JSON. There's nothing to install and no key to get — you can literally click one:

https://api.tradeti.me/v1/exchanges/nyse/status — opens the live answer for the New York Stock Exchange in your browser.

From the command line with curl:

curl "https://api.tradeti.me/v1/exchanges/nyse/status"

You get back something like this — open tells you the answer, the rest gives you context:

{
  "id": "nyse",
  "name": "NYSE",
  "open": true,             // ← the answer
  "status": "main_open",     // what kind of open (see Field glossary)
  "timeToCloseHours": 5.5    // closes in 5½ hours
}

Base URL: every path below hangs off https://api.tradeti.me. That's it — you're ready.

Core concepts

Five things worth knowing before you dive into the endpoints. Skim these and everything else clicks.

Authentication

There is none — and that's intentional. No key, no account, no cookies. Just request the URL. Because it's read-only public data, there's nothing to secure on your side. It also sends Access-Control-Allow-Origin: *, so browser front-ends can call it without a proxy.

List exchanges

{ "count": 30, "exchanges": [
  { "id": "nikkei", "name": "Nikkei 225", "city": "Tokyo",
    "timezone": "Asia/Tokyo", "region": "Asia", "importance": "major" },
  … ] }

One exchange (full record)

Is it open? — one exchange

{
  "id": "nyse", "name": "NYSE", "timezone": "America/New_York",
  "open": true,
  "status": "main_open",
  "sessionType": "main",
  "timeToNextHours": 0,
  "timeToCloseHours": 5.5,
  "closedReason": null
}

{
  "id": "nyse", "open": false, "status": "closed",
  "timeToNextHours": 38.5,          // opens Monday morning
  "closedReason": "weekend"
}

Everything open right now

{ "count": 30, "openCount": 8,
  "exchanges": [ { "id": "nikkei", "open": true, "status": "main_open" }, … ] }

Holidays & early closes

{
  "id": "nyse", "timezone": "America/New_York",
  "holidays": ["2026-01-01", "2026-07-03", "2026-12-25", …],
  "earlyCloses": [ { "date": "2026-11-27", "closeTime": 13 } ]  // closes 1:00pm
}

Trading sessions

{ "id": "nikkei", "timezone": "Asia/Tokyo",
  "sessions": { "pre": [8, 9], "main": [9, 11.5, 12.5, 15], "post": [15, 16.5] } }
  // main: open 9:00–11:30, lunch, then 12:30–15:00

Machine spec & health

GET /v1/openapi.json — the full OpenAPI 3.1 description of this API. OpenAPI is a standard format that tools understand: drop this URL into Postman, a code generator, or an AI, and it can call every endpoint for you.

GET /v1/health — a tiny liveness check: { "status": "ok", "exchanges": 30 }.

Field glossary

Every field you'll see in a status response, in plain terms:

Errors & status codes

Standard HTTP codes. Errors return a small JSON body { "error": "…" }.

Rate limits & caching

This is a free, keyless API on a shared budget — every request costs the same pool, and a single runaway client could take it down for everyone. So there's one simple rule: cache, and don't poll faster than the data changes. Follow it and you'll never see a limit.

Be a good citizen

• Cache each response on your side. Every response carries a Cache-Control header telling you how long it's valid — reference data (exchanges, holidays, sessions) for 24 hours, live status for 30 seconds. Reuse the cached copy instead of re-fetching.
• Poll no faster than the data changes. Status moves at most every 30s; a market clock refreshing once a minute is plenty.
• Batch. Call GET /v1/status once for all exchanges — not 30 separate calls.

Hit a 429? Here's the fix

A 429 Too Many Requests means one IP sent a burst far beyond normal use in a short window. It's served at Cloudflare's edge with a Retry-After header, and it's a short timeout, not a ban — the moment you slow down, you're through again:

HTTP/2 429 Too Many Requests
retry-after: 10
server: cloudflare

error code: 1015    // blocked at the edge — costs you nothing but a short pause

The fix is almost always the same — cache, slow the loop, and honor Retry-After:

setInterval(async () => {
  const s = await (await fetch(url)).json();  // every 100ms → 429
  render(s);
}, 100);

async function tick() {
  const r = await fetch(url);
  if (r.status === 429) {                       // backed off politely
    return setTimeout(tick, (+r.headers.get("retry-after") || 60) * 1000);
  }
  render(await r.json());
  setTimeout(tick, 60000);                       // once a minute is plenty
}
tick();

Recipes

Is NYSE open right now?

const { open } = await (await fetch("https://api.tradeti.me/v1/exchanges/nyse/status")).json();
if (open) console.log("NYSE is open");

Which markets are trading?

const { exchanges } = await (await fetch("https://api.tradeti.me/v1/status")).json();
const openNow = exchanges.filter(e => e.open).map(e => e.name);

Only run my bot while Tokyo is open

import requests
s = requests.get("https://api.tradeti.me/v1/exchanges/nikkei/status").json()
if s["open"]:
    run_strategy()

Will the LSE be open at a specific time?

curl "https://api.tradeti.me/v1/exchanges/lse/status?at=2026-12-25T12:00:00Z"

FAQ

Fair use & terms

Free during the current period, with no hard caps — just be a good citizen: cache responses, don't scrape in tight loops, and don't present the data as a guaranteed real-time or authoritative feed. It's provided as-is, for convenience; verify with the official exchange before any decision that depends on it. Full terms of use apply.

Feedback

This is only as good as it is correct, and only as complete as you tell us. Two things we always want: what's wrong, and what's missing. No account, 20 seconds.

Free today — not a promise forever. The API and MCP server are free and keyless in this early phase. As the service grows, its limits, terms, and pricing may change, and it's offered as-is with no guaranteed uptime. Build on it — just don't assume it stays free indefinitely.