Headless Oracle
@LembaGang
Cryptographically signed market status (OPEN/CLOSED/HALTED/UNKNOWN) for 28 global exchanges with Ed25519-signed receipts. Designed for AI agents and automated trading systems. Fail-closed: UNKNOWN always means CLOSED. 5 MCP tools. x402 micropayments on Base mainnet.
Overview
What is Headless Oracle?
Headless Oracle delivers Ed25519-signed market-state receipts for 28 global exchanges. It provides 5 MCP tools — get_market_status, get_market_schedule, list_exchanges, verify_receipt, get_payment_options — and uses fail-closed logic (UNKNOWN = CLOSED) with a 60-second time-to-live (TTL) and x402 micropayments on Base.
How to use Headless Oracle?
Install via npm with the command npx headless-oracle-mcp, then configure and invoke the available MCP tools according to your integration needs.
Key features of Headless Oracle
- Ed25519-signed market-state receipts
- Supports 28 global exchanges
- 5 MCP tools for market data and verification
- Fail-closed: UNKNOWN state treated as CLOSED
- 60-second TTL for receipt freshness
- x402 micropayments on Base
Use cases of Headless Oracle
—
FAQ from Headless Oracle
What does “fail-closed” mean?
When the market state is UNKNOWN, it is treated as CLOSED to ensure conservative decision-making.
How long is a receipt valid?
Each receipt has a time-to-live (TTL) of 60 seconds.
What payment mechanism is used?
Micropayments are handled via x402 on the Base network.
How many exchanges are covered?
The oracle covers 28 global exchanges.
What are the available MCP tools?
The five tools are: get_market_status, get_market_schedule, list_exchanges, verify_receipt, and get_payment_options.
