{
"id": "<string>",
"type": "large_trade_inserted_v2",
"created_at": "2023-11-07T05:31:56Z",
"data": {
"event_id": "<string>",
"whale_alert_id": 123,
"condition_id": "<string>",
"trader_id": 123,
"wallet": "<string>",
"size_usd": "<string>",
"shares": "<string>",
"price": "<string>",
"outcome_index": 123,
"traded_at": "2023-11-07T05:31:56Z",
"platform": "polymarket"
}
}large_trade_inserted_v2
Sends one large trade per delivery, with its market, wallet, grade, size, price, and trade time.
{
"id": "<string>",
"type": "large_trade_inserted_v2",
"created_at": "2023-11-07T05:31:56Z",
"data": {
"event_id": "<string>",
"whale_alert_id": 123,
"condition_id": "<string>",
"trader_id": 123,
"wallet": "<string>",
"size_usd": "<string>",
"shares": "<string>",
"price": "<string>",
"outcome_index": 123,
"traded_at": "2023-11-07T05:31:56Z",
"platform": "polymarket"
}
}trade_filters on the endpoint to receive only matching trades, by condition_id, wallet, min_grade, or min_size_usd. A trade must match every filter you set.
The Webhooks guide covers signatures, retries, and replay.Authorizations
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
v1= followed by the hex HMAC-SHA256 of {timestamp}.{raw body} under the endpoint signing secret. During a staged secret rotation it carries comma-separated v1= candidates: accept the delivery when any one verifies.
Unix seconds when this attempt was signed. Reject a delivery whose timestamp is more than 300 seconds from your clock.
The event id, equal to the body id.
The event type the endpoint registered, equal to the body type.
Stable key of this logical delivery (whdel_...). Every retry repeats it, so deduplicate on it.
Numeric id of this delivery, as a decimal string.
The delivery attempt counter, as a decimal string.
Body
Stable event id, identical across retries of the same logical event.
"large_trade_inserted_v2"When the producer recorded the event; for a trade event, the fill time. Retries resend the same body, so it is not the time of the attempt.
large_trade_inserted_v2 data (Pro and Max): one large trade, with the trade itself. The three amounts are decimal strings that keep the stored precision: parse them with a decimal library when the exact value matters. The endpoint's trade_filters decide which trades it receives.
Show child attributes
Show child attributes
Response
Return any 2xx status to acknowledge the delivery. Any other status, a redirect, a timeout or a connection error is retried on the published retry policy.
Was this page helpful?