Headless Oracle

Headless Oracle provides cryptographically signed market status receipts for 28 global exchanges — equities, derivatives (CME, NYMEX, Cboe), and 24/7 crypto (Coinbase, Binance). Every response is Ed25519-signed with a 60-second TTL so autonomous agents can verify market state without trusting the operator. The architecture is fail-closed: UNKNOWN always means CLOSED. Handles DST transitions, exchange holidays, half-days, lunch breaks, and real-time circuit breaker overrides automatically.

MCP Endpoint

https://headlessoracle.com/mcp

Protocol: MCP 2024-11-05 over Streamable HTTP (POST). No auth required for MCP tools.

Configure in Claude Desktop / Cursor / Windsurf

{
  "mcpServers": {
    "headless-oracle": {
      "url": "https://headlessoracle.com/mcp"
    }
  }
}

MCP Tools

Batch execution gate: GET /v5/batch?mics=XNYS,XLON,XJPX returns per-exchange signed receipts plus a summary.safe_to_execute boolean — true only when all exchanges are OPEN and none are HALTED or UNKNOWN.

Quick Start

MCP (ask your AI):

Is NYSE open right now?

curl (public demo — no key):

curl "https://headlessoracle.com/v5/demo?mic=XNYS"

curl (schedule):

curl "https://headlessoracle.com/v5/schedule?mic=XLON"

JavaScript (verify a receipt):

npm install @headlessoracle/verify

import { verify } from '@headlessoracle/verify';

const res = await fetch('https://headlessoracle.com/v5/demo?mic=XNYS');
const receipt = await res.json();

const result = await verify(receipt);
if (!result.valid || receipt.status !== 'OPEN') {
  throw new Error('Market not open or receipt invalid — halting');
}

Python:

pip install headless-oracle

from headless_oracle import OracleClient, verify

client = OracleClient()
receipt = client.get_status('XNYS')

if not verify(receipt) or receipt['status'] != 'OPEN':
    raise RuntimeError('Market not open — halting execution')

Fail-Closed Contract

Every receipt expires after 60 seconds (expires_at). Re-fetch before acting on a cached receipt.

Supported Exchanges (28)

MIC codes follow ISO 10383. XCOI (Coinbase) and XBIN (Binance) are community convention identifiers.

All Endpoints

Full API reference: headlessoracle.com/docs

x402 Autonomous Payments

Agents can pay for API access autonomously using USDC on Base mainnet — no human in the loop.

POST /v5/x402/mint

Send a Base mainnet USDC transaction hash to mint a persistent API key. Pricing: $99 USDC → builder plan (50K calls/day), $299 USDC → pro plan (200K calls/day).

Discovery document: /.well-known/x402.json

Verification SDKs

All SDKs use the public key from /.well-known/oracle-keys.json and verify Ed25519 signatures locally — no trust in the operator required.

Standards

• SMA Protocol v1.0 — github.com/LembaGang/sma-protocol

• Agent Pre-Trade Safety Standard — github.com/LembaGang/agent-pretrade-safety-standard