Skip to main content
GET
Page counterparty executions
Page the executions behind one whale trade’s counterparty snapshot. Use this endpoint when Get Whale Trade returns an executions_next_cursor.

Read the page

  • snapshot_id is required. Copy it from counterparty_analysis.snapshot_id in the trade detail.
  • data has the same CounterpartyAnalysis shape as the detail. executions[] carries the taker, an inline makers page, and makers_next_cursor.
  • executions_next_cursor is the cursor for the next page. It is null on the last page.
  • analysis_id binds every cursor to one snapshot and one execution set.
  • limit is 1 to 100 with a default of 100.

Handle the snapshot

  1. Read error.reason on a 400. cursor_expired means the snapshot expired or was invalidated.
  2. Request the trade detail again. Restart from its new snapshot_id.
  3. A 404 means the snapshot_id is unknown or belongs to another trade.
  4. A 503 with error.reason="read_model_warming" means the counterparty runtime is unavailable. Retry this route after Retry-After.
Page maker counterparties continues one execution from makers_next_cursor.

Authorizations

Authorization
string
header
required

API key authentication. Send your key in the Authorization header as Bearer oxi_sk_live_.... Live keys require an active Pro subscription and return live data.

Path Parameters

id
string
required

Whale trade ID. Accepts wt_-prefixed or raw whale_alerts.id.

Query Parameters

snapshot_id
string
required

Counterparty snapshot ID from the whale trade detail response.

cursor
string

Opaque cursor from the previous response's next_cursor.

limit
integer
default:100

Maximum number of counterparty execution rows to return.

Required range: 1 <= x <= 100

Response

Counterparty execution page

object
string
required
Allowed value: "counterparty_analysis"
data
object
required
meta
object
required