---
name: headless-oracle
description: Ed25519-signed market-state receipts for 28 global exchanges. Pre-trade verification gate for autonomous financial agents. UNKNOWN = CLOSED.
metadata:
  x402:
    endpoint: https://headlessoracle.com/v5/status
    price: "1000"
    currency: USDC
    network: eip155:8453
    testnet: eip155:84532
    asset: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
  erc8004: "8453:38413"
  agent_card: https://headlessoracle.com/.well-known/agent.json
  agents_md: https://headlessoracle.com/AGENTS.md
  mcp_endpoint: https://headlessoracle.com/mcp
---

# Headless Oracle

Headless Oracle provides cryptographically signed market-state receipts for 28 global exchanges. Every receipt is Ed25519-signed with a 60-second TTL — a verifiable pre-trade attestation that the agent checked market state before executing.

**Critical safety rule**: `UNKNOWN` and `HALTED` MUST be treated as `CLOSED` — halt all execution immediately.

## Pricing

**$0.001 USDC per call** via x402 micropayments — no subscription, no API key required.

- **Network**: Base mainnet (eip155:8453) + Base Sepolia testnet (eip155:84532)
- **x402 payment endpoint**: https://headlessoracle.com/v5/status
- **ERC-8004 registry**: 8453:38413
- **Ampersend listing**: https://app.ampersend.ai/agents/headless-oracle

## Usage

Check market status before executing a trade or financial operation:

```bash
# Inspect payment requirements (no charge)
ampersend fetch --inspect "https://headlessoracle.com/v5/status?mic=XNYS"

# Check if NYSE is open — pays $0.001 USDC automatically
ampersend fetch "https://headlessoracle.com/v5/status?mic=XNYS"

# Check other exchanges
ampersend fetch "https://headlessoracle.com/v5/status?mic=XLON"
ampersend fetch "https://headlessoracle.com/v5/status?mic=XJPX"
```

## Response

Returns an Ed25519-signed JSON receipt:

```json
{
  "mic": "XNYS",
  "status": "OPEN",
  "timestamp": "2026-04-01T14:30:00Z",
  "expires_at": "2026-04-01T14:31:00Z",
  "issuer": "headlessoracle.com",
  "key_id": "key_2026_v1",
  "receipt_mode": "live",
  "schema_version": "v5.0",
  "signature": "..."
}
```

Status values: `OPEN` | `CLOSED` | `HALTED` | `UNKNOWN`

**UNKNOWN and HALTED = CLOSED. Halt all execution.**

## Verify the Signature

```bash
# After receiving a receipt, verify the Ed25519 signature offline
# npm install @headlessoracle/verify
import { verify } from '@headlessoracle/verify';
const result = await verify(receipt);
if (!result.valid) throw new Error(`Invalid receipt: ${result.reason}`);
```

## Supported Exchanges (28)

| Region | MICs |
|--------|------|
| Americas | XNYS, XNAS, XBSP |
| Europe | XLON, XPAR, XSWX, XMIL, XHEL, XSTO, XIST |
| Middle East / Africa | XSAU, XDFM, XJSE |
| Asia | XSHG, XSHE, XHKG, XJPX, XKRX, XBOM, XNSE, XSES |
| Pacific | XASX, XNZE |
| Derivatives | XCBT, XNYM, XCBO |
| 24/7 Crypto | XCOI, XBIN |

## MCP Integration (No x402 Required)

Connect to the MCP server for tool-based access within Claude, Cursor, or any MCP-compatible agent:

```json
{
  "mcpServers": {
    "headless-oracle": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://headlessoracle.com/mcp"]
    }
  }
}
```

**Protocol**: MCP 2024-11-05 | **Endpoint**: https://headlessoracle.com/mcp

Available tools:
- `get_market_status` — signed receipt (OPEN/CLOSED/HALTED/UNKNOWN) for any MIC
- `get_market_schedule` — next open/close times in UTC
- `list_exchanges` — directory of all 28 supported exchanges
- `verify_receipt` — Ed25519 signature verification in-worker

## Discovery

- **Agent card (A2A)**: https://headlessoracle.com/.well-known/agent.json
- **AGENTS.md**: https://headlessoracle.com/AGENTS.md
- **MCP server card**: https://headlessoracle.com/.well-known/mcp/server-card.json
- **OpenAPI 3.1**: https://headlessoracle.com/openapi.json
- **Public key registry**: https://headlessoracle.com/v5/keys
- **x402 discovery**: https://headlessoracle.com/.well-known/x402.json