Skip to main content
GET
cURL
Use this for a weekly email, a dashboard, or a research review. A whale trade is one large Polymarket fill that 0xinsider recorded, and Whale trades lists them one at a time. Reports returns the same body through one granularity selector.

​
Parameters

Send either week, or both from and to. If you send none of them, you get 400 with error.param from. If you send all three, from and to decide the range. A range wider than 31 inclusive days answers 400 with error.reason invalid_query and error.param from. A from later than to answers 400 with error.param from. Neither case is trimmed to fit.

​
When the numbers stop changing

A report is final only once its body is built after the range has closed and after the trades from those dates have had time to arrive. That cutoff is snapshot.final_after: the UTC close of end_date plus the 7,530-second ingestion budget. Until that instant snapshot.status is rolling and every number can still move. A closed range refreshes every 5 minutes until final_after, is rebuilt once after it, and is then frozen.

​
Key response fields

​
Example

​
What it does not return

  • A 404 for a quiet week. A range with no large trades answers 200 with completeness.status empty.
  • A trimmed range. A from and to range wider than 31 inclusive UTC days answers 400 invalid_query instead of being cut down to fit.
  • A settled figure while the range includes today, or in the 7,530 seconds after it ends. Wait for snapshot.status final.
  • A from and to range on every request. When too many custom ranges are being computed at once, you get 503 with error.reason read_model_warming and a Retry-After of 5 seconds.

Authorizations

​
Authorization
string
header
required

Legacy default or named integration API key, or OAuth 2.1 access token, in the Authorization header as Bearer oxi_sk_live_... or Bearer oxi_at_.... Default keys retain full access; integration keys are limited to their approved read, webhooks, export and usage scopes and expire within 90 days. All credentials share the owner's account limits. Data calls require an active Pro subscription and return live data. A 401 carries WWW-Authenticate: Bearer resource_metadata="https://api.0xinsider.com/.well-known/oauth-protected-resource" (RFC 6750 section 3, RFC 9728).

Headers

​
X-Query-Validation
enum<string>

Opt into strict query-name validation. The default is compatible: unknown names are ignored and reported in X-Query-Ignored. With strict, an unknown name returns 400 bad_request with error.reason unknown_query_parameter before the handler runs, including when its percent escape is incomplete.

Available options:
strict

Query Parameters

​
from
string

UTC source-range start in YYYY-MM-DD format; required with to. Together with to, selects an exact ephemeral range of at most 31 inclusive UTC days. A start after tomorrow UTC returns 400 bad_request with error.param=from.

Pattern: ^\d{4}-\d{2}-\d{2}$
​
to
string

UTC source-range end in YYYY-MM-DD format; required with from. Together with from, selects an exact ephemeral range of at most 31 inclusive UTC days. An end before 2024-03-01, the first day report data covers, returns 400 bad_request with error.param=to.

Pattern: ^\d{4}-\d{2}-\d{2}$
​
week
string

ISO week selector in YYYY-WW format; alternative to from/to. Selects a durable canonical snapshot. A week that ends before 2024-03-01, the first day report data covers, or starts after tomorrow UTC returns 400 bad_request with error.param=week.

Pattern: ^\d{4}-\d{2}$

Response

Weekly report snapshot

​
object
string
required
Allowed value: "report_snapshot"
​
data
object
required
​
meta
object
required