Skip to main content
GET
Page counterparty executions
Use this endpoint when Large trade returns executions_next_cursor. The trade detail includes the first 100 executions; this route returns the next page in the same CounterpartyAnalysis format. An execution is one OrdersMatched event on Polygon, with 1 taker and 1 or more makers. Keep the same snapshot_id while you fetch additional pages.

Parameters

Key response fields

When a request fails

Example

What it does not return

  • The trade’s own fields. size_usd, price, and the wallet that made the trade stay on Large trade.
  • Every maker of a busy execution. Follow that execution’s makers_next_cursor with Counterparty makers.
  • A page from a different snapshot. The cursor is tied to one analysis_id, so sending it against another snapshot is refused rather than silently answered.

Caching

Save the response’s ETag and send it in If-None-Match on your next request. If the page has not changed, the server returns 304 Not Modified with no body.

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

Path Parameters

id
string
required

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

Query Parameters

snapshot_id
string
required

Counterparty snapshot ID from the large 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. Out-of-range values are clamped to 1..100.

Required range: 1 <= x <= 100

Response

Counterparty execution page

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