Ask the hour before the swap.
Robinhood stock tokens trade on Robinhood Chain all 168 hours of the week. The New York regular session that sets the real share price runs for 32.5 of them. CURFEW is one read-only call that tells an agent whether the conditions for a fair price are there right now, at its size.
How the verdict is made
Three checks run on every call. Each gives OPEN, CAUTION or CURFEW; the worst one is the answer. Every check returns its reason in plain English.
Example values to show the flow, not a live reading. The real answer is further down this page.
| Check | OPEN | CAUTION | CURFEW |
|---|---|---|---|
| Session | Regular, 09:30-16:00 ET (13:00 on early closes) | Pre-market 04:00-09:30, after hours to 20:00, overnight (policy extended) | Fri 20:00 to Sun 20:00 and NYSE holidays (policy closed) |
| Reference | Moving | Unchanged for 6 h while New York is open | Older than 3 days, or unreadable |
| Gap | Within maxGapBps (100) | Worse than the limit, or better than the reference by more than it | Worse than 2x the limit, or no pool can quote the size |
Gap is signed from the trader's side: for a buy, pool price / Chainlink - 1; for a sell, 1 - pool price / Chainlink. Positive is worse than the reference. The pool price is what the best Uniswap v3 route gives for your exact amount in USDG: direct USDG pools at 0.05%, 0.3% and 1%, and via WETH at every fee pair.
Some Chainlink feeds on Robinhood Chain keep updating after the close and some sit still for hours; that is why CURFEW reports the measured age instead of assuming either.
MCP
Streamable HTTP, stateless, no key. Endpoint: https://curfewhq.xyz/mcp. Three tools, all marked read-only.
# Claude Code
claude mcp add --transport http curfew https://curfewhq.xyz/mcp
# Cursor: ~/.cursor/mcp.json
{ "mcpServers": { "curfew": { "url": "https://curfewhq.xyz/mcp" } } }
# Claude desktop / claude.ai: Settings, Connectors, Add custom connector, paste the URL
| Tool | Arguments | Returns |
|---|---|---|
check_trade | ticker, side (buy or sell), usd, optional policy | Verdict, reasons, reference, pool price, gap, route, next open/close |
stock_gaps | none | All 12 tokens at $100: reference, age, buy and sell gap, verdict |
market_clock | none | Session, New York time, next open and close, this week's hours, next holidays |
HTTP API
GET or POST /api/check
curl "https://curfewhq.xyz/api/check?ticker=NVDA&side=buy&usd=2500"
curl -X POST https://curfewhq.xyz/api/check -H 'content-type: application/json' \
-d '{"ticker":"TSLA","side":"sell","usd":20000,"policy":{"maxGapBps":60,"extended":"block","closed":"block"}}'
| Field | Values |
|---|---|
ticker | TSLA, NVDA, AAPL, GOOGL, AMZN, META, MSFT, AMD, COIN, MSTR, PLTR, SPY |
side | buy (USDG in) or sell (shares worth usd at the reference) |
usd | 1 to 250,000 |
policy.maxGapBps | 5 to 2000, default 100 |
policy.extended, policy.closed | allow, caution or block; defaults caution and block |
GET /api/board
All 12 tokens at $100 with the default policy. Cached for 60 seconds.
GET /api/clock
The session now, next regular open and close, this week's session blocks and upcoming holidays. No chain call.
GET /api/history?ticker=TSLA
Snapshots the server records every 5 minutes (reference, buy gap, sell gap, reference age, session), up to 7 days. Only what this server saw; nothing is backfilled.
POST /rpc
A read-only proxy to Robinhood Chain for the browser: eth_chainId, eth_blockNumber, eth_call, eth_getBlockByNumber (no full transactions), eth_gasPrice.
The guard
One small function your agent calls before it builds a swap. It throws on CURFEW, returns OPEN or CAUTION, and fails closed when CURFEW cannot be reached. Download guard.js.
import { curfew, CurfewError } from "./guard.js";
try {
const r = await curfew("NVDA", "buy", 2500, { maxGapBps: 80 });
if (r.verdict === "CAUTION") await askOwner(r.text);
// build, sign and send the swap with your own wallet here
} catch (e) {
if (e instanceof CurfewError) log("not now:", e.answer.text);
}
The answer
A real answer from this server, filled in when the page loads:
{ "verdict": "…" }
Calendar
Times are New York time (America/New_York, so EST and EDT are handled). Holidays and early closes come from the NYSE calendar and run to the end of 2027; they are refreshed every December. On a holiday the whole New York day is closed, and the night before it and the night after it carry no overnight session.
| Date | Day | Market |
|---|
Limits and honesty
- 40 checks a minute per IP, 90 MCP requests, 120 other API requests.
- Read-only. CURFEW never signs, sends or holds anything, and never sees a key.
- A verdict says whether conditions for a fair price are present. It is not a signal to buy or sell, and a quote is what the pool would give at that block.
- Halts, dividends and splits are not checked yet (planned).
- Live beta, not audited. Not affiliated with Robinhood, NYSE or Chainlink.
Source and self-hosting
Plain Node, no packages: node serve.mjs. The logic is three small files: src/clock.js (the New York calendar), src/verdict.js (the rules) and src/market.js (Chainlink and Uniswap reads with hand-encoded ABI). Unit tests run with npm test. The public repository link appears here at launch.