List HIP-4 questions

Authorizations

X-API-Key

string

header

required

API key for authentication. Get yours at https://0xarchive.io/dashboard

Headers

0xArchive-Version

enum<string>

Selects the 2026-10 response contract. Send 2026-10-01; any dated version on or after it selects the same shapes. Without the header every response keeps its existing shape. With it:

The data quality routes, /v1/status/coverage and /v1/symbols answer the standard {success, data, meta} envelope.
Record times that are integer milliseconds by default become RFC 3339 UTC strings with millisecond precision, and the integer moves to a *_ms field: L4 resting-order timestamp (timestamp_ms), CVD buckets, HIP-3 oracle reads, Lighter and Lighter on Robinhood Chain liquidations and liquidation volume. Levels and trigger-levels snapshot_ts become RFC 3339 with snapshot_ts_ms.
Error bodies carry the contract error_code names: invalid_parameter instead of invalid_query_params and invalid_path_params, historical_depth_exceeded instead of history_window_exceeded, and historical_range_exceeded instead of request_range_exceeded; a malformed cursor that fails to parse answers 400 invalid_cursor instead of invalid_query_params. With 0xArchive-Version: 2026-10-01, malformed cursors on trades, liquidations, L2 and L4 diffs, order history, TP/SL and order-flow routes answer 400 invalid_cursor. Without the header, the first six route families treat a malformed cursor as no cursor and return the first page; order flow answers 400 invalid_query_params. Malformed trade time inputs answer 400 invalid_time_range with the header and 400 invalid_query_params without it.

The response echoes the selected version in its own 0xArchive-Version header.

Available options:

2026-10-01

Example:

"2026-10-01"

Query Parameters

cursor

string

Opaque pagination cursor: pass meta.next_cursor from the previous page unchanged, with the same filters. Omit it for the first page.

limit

integer

default:100

Maximum number of results (default: 100, max: 1000)

Required range: x <= 1000

Response

HIP-4 questions

API response containing HIP-4 questions.

success

boolean

Example:

true

data

object[]

Hide child attributes

data.question_id

integer<int64>

required

Question identifier.

Example:

0

data.name

string

required

Question name as published on-chain (recurring markets use a generic name such as Recurring).

Example:

"Recurring"

data.description

string

required

Pipe-delimited question metadata (class, underlying, expiry, price thresholds, period).

Example:

"class:priceBucket|underlying:BTC|expiry:20260508-0600|priceThresholds:79303,82540|period:1d"

data.fallback_outcome_id

integer<int64>

required

Outcome ID that resolves Yes when no named outcome does.

Example:

6

data.named_outcome_ids

integer<int64>[]

required

Outcome IDs of the named choices grouped under this question.

Example:

[7, 8, 9]

data.settled_named_outcomes

integer<int64>[]

required

Subset of named_outcome_ids that have already settled.

Example:

[]

data.first_seen_at

string<date-time>

required

When this question was first observed by 0xArchive (UTC).

Example:

"2026-05-08T05:57:28.326Z"

data.last_updated_at

string<date-time>

required

When this question row was last updated (UTC).

Example:

"2026-05-08T05:57:28.326Z"

Endpoint reference

Requests and responses

Datasets

Venues

OpenAPI and schemas

Guides

List HIP-4 questions

Authorizations

Headers

Query Parameters

Response