Resolutions
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. |
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_totalno_shares_micro_totalnet_shares_micro_totalnet_balance_minor_totalcurrency_code
Each item contains:
- nested
market.id,market.slug,market.title resolved_atoutcome:yesornoyes_shares_microno_shares_micronet_shares_microlosing_value_minorwinning_value_minornet_balance_minorcurrency_codefx_rate_snapshot: latest snapshot used by a processed auto-redemption item for this operator and market, ornull; containsid,provider,pair,rate, andquoted_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 the resolved_from / resolved_to filters are based on markets.updated_at in the v1 API. Treat them as approximations until a dedicated resolved timestamp is exposed.