headlessoracle.com
No description published for this endpoint.
TradingLiveeip155:8453Exactvia facilitator:thirdweb
Calls · 30d
14↑ 117%
This endpoint's own trailing-30-day call count, as published by the upstream catalog and snapshotted daily. 30 snapshots so far.
$0.02
Verified settled volume
20 settlements proven x402 by their on-chain EIP-3009 marker.
$0.0010
Listed price
As published in the catalog. Always read the live 402 before paying.
—
Calls · 30d
Upstream's own call count for this endpoint, not ours.
—
Unique payers · 30d
Never called
—
Upstream on-chain volume
Reported by the source catalog.
Paid to
0x26D4Ffe98017D2f160E2dAaE9d119e3d8b860AD3The wallet the 402 directs payment to. Its whole payment record — every payer, every chain — is on the merchant page.
Asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
Provider
The payTo wallet does not resolve to a registered ERC-8004 agent. That is not a verdict on the service — most of the catalog is unregistered.
Live 402 challenge
Captured by the enrichment pass, not read just now. Prices can change — always read the 402 the endpoint answers with.
{
"docs": "https://headlessoracle.com/docs",
"error": "Payment Required",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"input": {
"type": "object",
"required": [
"mic"
],
"properties": {
"mic": {
"type": "string",
"example": "XNYS",
"description": "ISO 10383 Market Identifier Code (e.g. XNYS, XNAS, XLON)"
}
}
},
"payTo": "0x26D4Ffe98017D2f160E2dAaE9d119e3d8b860AD3",
"scheme": "exact",
"network": "base",
"mimeType": "application/json",
"resource": "https://headlessoracle.com/v5/status/x402",
"description": "Signed market-state receipt for one exchange. OPEN/CLOSED/HALTED/UNKNOWN - Ed25519 signed, 60s TTL.",
"maxAmountRequired": "1000",
"maxTimeoutSeconds": 300,
"paymentHeaderName": "X-Payment",
"paymentHeaderEncoding": [
"base64-json",
"json"
]
}
],
"extensions": {
"bazaar": {
"info": {
"tags": [
"market-state",
"exchange-status",
"pre-trade",
"attestation",
"Ed25519",
"trading-hours",
"holiday-calendar",
"fail-closed",
"28-exchanges",
"signed-receipt",
"MIC",
"ISO-10383"
],
"input": {
"type": "http",
"method": "GET",
"queryParams": {
"mic": "XNYS"
}
},
"family": "market-state",
"output": {
"type": "json",
"format": "application/json",
"example": {
"mic": "XNYS",
"issuer": "headlessoracle.com",
"source": "SCHEDULE",
"status": "OPEN",
"issued_at": "2026-06-05T16:03:15.257Z",
"signature": "ab5413710ca2c4b71a5241efe3be386b6e2d3e1746deb1686e42c2f718cdb76e6e4e5a077817c972e8c1c04a301da5465b147b533fc1e4505523f81d35b98901",
"expires_at": "2026-06-05T16:04:15.257Z",
"receipt_id": "eb2a23e4-c3cc-49dc-aa1e-e443eb89045e",
"receipt_mode": "live",
"public_key_id": "key_2026_v1",
"halt_detection": "active",
"schema_version": "v5.0"
}
},
"category": "financial-data",
"pricingUrl": "https://headlessoracle.com/v5/pricing",
"description": "Ed25519-signed market-state receipt for one of 28 global exchanges. Pre-trade verification gate for autonomous financial agents. UNKNOWN = CLOSED (fail-closed). 60-second TTL. Holiday-aware, DST-correct, real-time halt detection for XNAS and XNYS only; schedule-based for the other 26.",
"exampleNote": "output.example is a real receipt captured 2026-06-05T16:03:15Z. Its Ed25519 signature verifies against key_2026_v1 published at /v5/keys (now expired by TTL - schema-illustrative).",
"metadataUrl": "https://headlessoracle.com/.well-known/mcp/server-card.json",
"documentationUrl": "https://headlessoracle.com/docs"
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method",
"queryParams"
],
"properties": {
"type": {
"const": "http"
},
"method": {
"enum": [
"GET"
]
},
"queryParams": {
"type": "object",
"required": [
"mic"
],
"properties": {
"mic": {
"enum": [
"XNYS",
"XNAS",
"XLON",
"XJPX",
"XPAR",
"XHKG",
"XSES",
"XASX",
"XBOM",
"XNSE",
"XSHG",
"XSHE",
"XKRX",
"XJSE",
"XBSP",
"XSWX",
"XMIL",
"XIST",
"XSAU",
"XDFM",
"XNZE",
"XHEL",
"XSTO",
"XCBT",
"XNYM",
"XCBO",
"XCOI",
"XBIN"
],
"type": "string",
"description": "ISO 10383 Market Identifier Code"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type",
"example"
],
"properties": {
"type": {
"const": "json"
},
"format": {
"const": "application/json"
},
"example": {
"type": "object",
"required": [
"receipt_id",
"issued_at",
"expires_at",
"issuer",
"mic",
"status",
"source",
"halt_detection",
"receipt_mode",
"schema_version",
"public_key_id",
"signature"
],
"properties": {
"mic": {
"type": "string",
"description": "ISO 10383 Market Identifier Code"
},
"issuer": {
"const": "headlessoracle.com"
},
"source": {
"enum": [
"SCHEDULE",
"OVERRIDE",
"SYSTEM",
"REALTIME"
]
},
"status": {
"enum": [
"OPEN",
"CLOSED",
"HALTED",
"UNKNOWN"
],
"description": "UNKNOWN must be treated as CLOSED (fail-closed contract)."
},
"coverage": {
"type": "string",
"description": "JSON-encoded string inside the signed bytes; JSON.parse it after verifying the signature. Added to the signed payload by commit 19ccb28 (2026-09-07); the example below predates it."
},
"issued_at": {
"type": "string",
"format": "date-time"
},
"signature": {
"type": "string",
"pattern": "^[0-9a-f]{128}$",
"description": "Ed25519 signature over canonical (alphabetical, no-whitespace) JSON of the payload, hex-encoded."
},
"expires_at": {
"type": "string",
"format": "date-time",
"description": "issued_at + 60s. Signed into the canonical payload - consumers must reject expired receipts."
},
"receipt_id": {
"type": "string",
"format": "uuid"
},
"receipt_mode": {
"enum": [
"demo",
"live"
]
},
"public_key_id": {
"type": "string",
"description": "Active key ID published at /v5/keys"
},
"halt_detection": {
"enum": [
"active",
"schedule_only"
]
},
"schema_version": {
"const": "v5.0"
}
}
}
}
}
}
}
}
},
"x402Version": 1,
"agent_actions": {
"pay_per_request": {
"description": "Send Payment-Signature (x402 v2) or X-Payment (v1) header to pay $0.001 USDC and get this receipt immediately",
"header_names": [
"Payment-Signature",
"X-Payment"
],
"payment_spec": "/.well-known/x402.json",
"accepted_formats": [
"base64-json (x402 standard — use x402 client library)",
"raw JSON { txHash, network, amount, paymentAddress, memo } (direct on-chain)"
],
"example_flow_x402": "1. Use x402 client to create payment → 2. Library sets X-Payment header automatically → 3. Send request",
"example_flow_direct": "1. Send 1000 units USDC to paymentAddress on Base mainnet → 2. Get txHash → 3. Set X-Payment: {\"txHash\":\"0x...\",\"network\":\"base\",\"amount\":\"1000\",\"paymentAddress\":\"<addr>\",\"memo\":\"...\"} → 4. Send request"
},
"payment_address": "0x26D4Ffe98017D2f160E2dAaE9d119e3d8b860AD3",
"buy_subscription": {
"url": "https://headlessoracle.com/upgrade",
"description": "Human-driven checkout — get a permanent key with monthly billing"
},
"mint_persistent_key": {
"body": "{ \"tx_hash\": \"0x...\", \"tier\": \"builder\", \"network\": \"base\", \"signature\": \"0x...\" }",
"tiers": {
"pro": "$299 USDC → 200K req/day",
"builder": "$99 USDC → 50K req/day"
},
"endpoint": "POST /v5/x402/mint",
"description": "POST /v5/x402/mint with tx_hash of Base mainnet USDC payment, signed by the paying address — get a persistent API key",
"message_to_sign": "headlessoracle.com x402 mint <tx_hash>",
"signature_format": "EIP-191 personal_sign (keccak256(\"\\x19Ethereum Signed Message:\\n\" + byte length + message)) by the address that sent the USDC Transfer, as 65 bytes of 0x-prefixed hex (r || s || v, v = 27/28 or 0/1). The signer must be an EOA: smart-contract wallets (ERC-1271) are not supported."
},
"get_credits_instantly": {
"endpoint": "POST /v5/sandbox",
"body_x402": "omit body — use X-Payment header instead (same $0.001 USDC)",
"description": "POST /v5/sandbox with X-Payment header — get 10 credits immediately, no email required",
"credits_issued": 10,
"body_with_email": "{ \"email\": \"you@example.com\" }"
}
}
}Accepts
The payment requirements as published to the catalog. Read the live 402 before paying — a price here is a claim, not a quote.
0.001USDC≈ $0.001 USD
on Base · exact scheme
Pay 0.001 USDC on Base to 0x26D4…60AD3. The signed payment is good for 5 minutes.
- Paid to
- 0x26D4…60AD3
- USD Coin contract
- 0x8335…02913
- Payment window
- 5 minutes
- As published
- 1000 smallest units
- Returns
- application/json
The catalog’s raw entry
[
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x26D4Ffe98017D2f160E2dAaE9d119e3d8b860AD3",
"scheme": "exact",
"network": "eip155:8453",
"mimeType": "application/json",
"resource": "https://headlessoracle.com/v5/status/x402",
"description": "",
"maxAmountRequired": "1000",
"maxTimeoutSeconds": 300
}
]Provenance
- Seen in the source catalog
- 2026-10-14 05:18Z
- Last indexed by Roundhouse
- 2026-10-19 14:45Z
- Last enriched (probe, favicon, geo)
- 2026-10-08 16:46Z
- x402 version
- 1
- Max timeout
- 300s
- Liveness probe
- HTTP 402
Hand this page to an agent
Copy the prompt and paste it into Claude, an MCP client or your own agent — it will vet this service and call it over the free read API. No key, no account.
GET api.roundhouseai.io/v0/endpoints
This endpoint's own trailing-30-day call count, as published by the upstream catalog and snapshotted daily. 30 snapshots so far. Verified volume counts only settlements with an on-chain EIP-3009 marker.
Show the promptHide the prompt
Using Roundhouse, look up the x402 service headlessoracle.com and tell me whether it is worth paying: what a call costs, whether the endpoint answered when last probed, and what its payment record actually shows. curl -s 'https://api.roundhouseai.io/v0/endpoints?q=headlessoracle.com' curl -s 'https://api.roundhouseai.io/v0/merchants/<the payTo wallet returned above>' Then call it: read the price from the live 402 at https://headlessoracle.com/v5/status/x402, never from a cached figure, and pay with an x402 client. The /v0 API needs an API key (`authorization: Bearer rh_live_…`) on everything except /v0/unified* and /v0/endpoints. Either pay over x402 (mint a personal key for $0.01 at GET https://api.roundhouseai.io/v0/test/x402), or ask me for an organization key, which I create at https://roundhouseai.io/dashboard/connections. If you have neither, ask before going further. If you do not have Roundhouse tools or skills installed, read https://roundhouseai.io/skill.md first — it is the whole procedure.