Skip to main content
GET
Page maker counterparties
Page the maker wallets on one exact execution of a whale trade. Use this endpoint when an execution carries a makers_next_cursor.

Read the makers

  • snapshot_id is required. execution_id comes from the parent execution.
  • items[] carries counterparty_key, execution_wallet, identity_status, display_name, grade, maker_fill_count, filled_shares, filled_usdc, and share_pct.
  • execution_wallet is the lowercase Polygon wallet from the OrderFilled log. identity_status is resolved, infrastructure, or unavailable.
  • share_pct keeps the complete execution as its denominator on every page.
  • match_breakdown[] splits fills by match_type: COMPLEMENTARY, MINT, or MERGE.
  • next_cursor is bound to the analysis, the execution, the last share total, and the wallet. It is null on the last page.
  • 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 counterparty executions lists the executions that carry these makers.

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.

execution_id
string
required

Counterparty execution ID from the parent response.

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 maker rows to return.

Required range: 1 <= x <= 100

Response

Counterparty maker page

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