Skip to main content
POST
Create an immutable whale dataset
Use a paid credential with export scope. The job belongs to the account that submitted it, and another account sees 404. For one wallet’s enriched dataset, use trader exports.

​
Parameters

A new job returns 202. An identical live normalized request returns the same job with 200, without another quota reservation. Dataset requests share the owner’s 20 exports per day and have a combined limit of 5 per hour. Different filters or keys do not increase those limits.

​
Key response fields

The status resource returns status, next_action, and poll_after_s. Poll only while next_action is poll. A ready artifact.manifest contains normalized filters, the selection clock, the commit horizon, row and byte counts, SHA-256 of both decoded and compressed bytes, the schema, source coverage, expiry, and replay continuation. The job can be queued, running, cancel_requested, ready, failed, reconcile_required, expired, or cancelled. It allows 3 worker claims and has a 24-hour artifact window. A failed or cancelled job still consumes its quota reservation. No partial file is available; a request exceeding 1,000,000 rows or 256 MiB uncompressed fails and must use a narrower window.

​
Continue with deltas

Send generation.continuation.cursor to durable replay, with the same normalized condition_id and min_size. The checkpoint includes trades already committed after to while the export waited, as well as later and still-open writers. It deliberately overlaps some snapshot rows. Deduplicate by wt_<whale_alert_id>: the snapshot’s id, expanded replay’s trade.id, or payload.whale_alert_id without expansion. Retain each returned replay cursor. The finite snapshot time bounds do not filter deltas, so a late trade can precede the original window. This is an insertion feed, not updates or deletions, and it never promises exactly-once delivery.

​
Example

​
What it does not return

Rows are detected whale_alerts, not complete provider trade history. Exact price and USD size are decimal strings. The dataset includes no current wallet grade or market enrichment. Legacy outcome indices are null where the canonical trust boundary cannot establish them. Ingestion and retention gaps remain source coverage limits.

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).

Body

application/json

Finite past [from, to) window up to 31 days, with optional stable source filters. Identical live normalized requests reuse their job without another reservation. A failed or expired job can be resubmitted.

​
from
string<date-time>
required
​
to
string<date-time>
required
​
condition_id
string

Raw provider condition id or mkt_-prefixed id.

​
min_size
number

USD minimum, normalized to cents like replay.

Required range: 0 <= x <= 1000000000000000

Response

Reused identical live dataset job.

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