Operator Api

Resolutions

Query resolved market exposure and payout liability for the operator.

Resolutions

Query resolved markets where this operator has current or settlement-time Mini App exposure.

Path

GET /api/operator/resolutions

Required scope: redemptions:read

Query params

All query parameters are optional.

Parameter	Type	Requirement	Values/default
`search`	string	Optional	Case-insensitive match against market slug or title.
`market`	string	Optional	Convenience filter: positive numeric market ID or exact market slug.
`market_id`	positive integer	Optional	Exact market ID. Takes precedence over a numeric `market`.
`market_slug`	string	Optional	Exact market slug. Takes precedence over a slug in `market`.
`resolved_from`	ISO 8601 date-time	Optional	Include rows whose approximate `resolved_at` is on or after this timestamp.
`resolved_to`	ISO 8601 date-time	Optional	Include rows whose approximate `resolved_at` is on or before this timestamp.
`resolved_from_date`	date (`YYYY-MM-DD`)	Optional	Inclusive Operator-local approximate resolution-date lower bound.
`resolved_to_date`	date (`YYYY-MM-DD`)	Optional	Inclusive Operator-local upper bound; cutoff is next-day local midnight.
`sort`	string	Optional	`resolved_at_desc` (default), `resolved_at_asc`, `net_desc`, or `net_asc`.
`page`	positive integer	Optional	Default `1`.
`page_size`	positive integer	Optional	Default `25`, maximum `100`.

Response fields

The response-level summary contains totals across all filtered rows, not only the current page:

yes_shares_micro_total
no_shares_micro_total
net_shares_micro_total
net_balance_minor_total
currency_code
timezone

Each item contains:

nested market.id, market.slug, market.title
resolved_at
outcome: yes or no
yes_shares_micro
no_shares_micro
net_shares_micro
losing_value_minor
winning_value_minor
net_balance_minor
currency_code
fx_rate_snapshot: latest snapshot used by a processed auto-redemption item for this operator and market, or null; contains id, provider, pair, rate, and quoted_at

Calculation rules

net_shares_micro is losing-side shares minus winning-side shares.

net_balance_minor is losing_value_minor - winning_value_minor in operator currency minor units.

Share exposure is reconstructed from current positions plus winning shares already deducted by Mini App redemption items. This matters because midnight redemption processing can deduct winning shares before an operator reviews the resolved market.

When multiple processed auto-redemption items exist for one market, fx_rate_snapshot comes from the most recently updated item (then highest item ID). A row without processed auto-redemption returns null. Pending winning-share projections still use the current request-time FX snapshot; processed payouts retain their stored operator-currency amounts.

Caveat

Current resolved_at and resolution date filters are based on markets.updated_at in v1 API. Treat them as approximations until dedicated resolved timestamp exists. Date-only filters use response summary.timezone.

Edit this pageorReport an issue

Trades

Query Mini App trade and order records.

Balance operations

Inspect operator wallet mutation records.