---
title: "Authenticated batch receipt query"
method: GET
path: "/v5/batch"
tags: ["Market State"]
---

# Authenticated batch receipt query

`GET /v5/batch`

## Request

- Base URL: `https://headlessoracle.com`
- URL: `https://headlessoracle.com/v5/batch`
- Auth: API key in header `X-Oracle-Key`

Returns independently signed receipts for multiple exchanges in one request. Each receipt goes through the same 4-tier fail-closed architecture as /v5/status. Receipts are built in parallel. Requires X-Oracle-Key header or x402 payment ($0.005 USDC for batch).

## Query parameters

- `mics` string, required

## Headers

- `Payment-Signature` string
- `X-Payment` string

## Response `200`

Batch of signed receipts

- object
  - `batch_id` string, uuid, required
  - `queried_at` string, date-time, required
  - `receipts` SignedReceipt[], required
    - `receipt_id` string, uuid, required
    - `issued_at` string, date-time, required
    - `expires_at` string, date-time, required: Do not act on this receipt after this time.
    - `issuer` string, required: Domain of the oracle that issued this receipt. Resolve {issuer}/v5/keys to retrieve the public key.
    - `mic` string, required
    - `status` 'OPEN' | 'CLOSED' | 'HALTED' | 'UNKNOWN', required: UNKNOWN MUST be treated as CLOSED. Halt all execution.
    - `source` 'SCHEDULE' | 'OVERRIDE' | 'SYSTEM' | 'REALTIME', required
    - `reason` string: Present when source is OVERRIDE.
    - `halt_detection` 'active' | 'schedule_only', required: "active" = real-time intraday halt detection via external API (XNYS, XNAS only). "schedule_only" = calendar hours + holidays only; unscheduled intraday circuit breaker halts are not detected. Agents must adjust confidence accordingly.
    - `receipt_mode` 'demo' | 'live', required: 'demo' for unauthenticated /v5/demo; 'live' for /v5/status, /v5/batch, and MCP tool receipts.
    - `schema_version` string, required: Receipt schema version. Consumers should verify this matches the version they were built against.
    - `public_key_id` string, required
    - `signature` string, required: Ed25519 signature of canonical payload as 128-char hex string.

## Other responses

- `400`: Missing mics parameter or unknown MIC
- `401`: Missing API key
- `403`: Invalid API key
- `500`: Signing system offline — CRITICAL_FAILURE

---

[API](https://skmtc.dev/headlessoracle/apis/headless-oracle.md) · [All operations](https://skmtc.dev/headlessoracle/apis/headless-oracle/llms.txt) · [OpenAPI document](https://skmtc.dev/headlessoracle/apis/headless-oracle/revisions/4e82fe332f29?raw)