Balance operations
Balance operations
Inspect wallet mutation records against operator adapter.
Path
GET /api/operator/balance-operations
Required scope: balance_operations:read
Query params
All query parameters are optional.
| Parameter | Type | Requirement | Values/default |
|---|---|---|---|
status | string | Optional | One of the operation statuses below. |
direction | string | Optional | One of the direction values below. |
type | string | Optional | trade or resolution. |
market | string | Optional | Convenience filter: positive numeric market ID or exact market slug. |
market_id | positive integer | Optional | Exact market ID; takes precedence over numeric market. |
market_slug | string | Optional | Exact market slug; takes precedence over a slug in market. |
external_user_id | string | Optional | Exact operator-side user ID. |
order_id | positive integer | Optional | Exact Mini App order ID. |
redemption_item_id | positive integer | Optional | Exact Mini App redemption item ID. |
created_from | datetime | Optional | Inclusive creation-time lower bound. |
created_to | datetime | Optional | Inclusive creation-time upper bound. |
sort | string | Optional | created_at_desc (default), updated_at_desc, or next_retry_at_asc. |
page | positive integer | Optional | Default 1. |
page_size | positive integer | Optional | Default 50, maximum 100. |
Direction values:
debitcreditdebit_reversalcredit_reversal
Status values:
plannedsentsucceededfailedunknownretryingmanual_review
Filtered summary
Every response includes a summary computed across all rows matching the same authenticated-operator and query-filter predicates as items and pagination.total. Summary values are not limited to the current page and are not implicitly restricted to succeeded; use status when a status-specific report is required.
| Field | JSON type | Definition |
|---|---|---|
credit_external_amount_minor_total | integer | Sum of non-negative operation amounts for credit and debit_reversal. |
debit_external_amount_minor_total | integer | Sum of non-negative operation amounts for debit and credit_reversal. |
volume_external_amount_minor_total | integer | Credits total plus debits total. |
currency_code | string | Authenticated operator's configured currency code. |
created_from and created_to remain inclusive for the summary, count, and rows. Dashboard date-only filters expand to 00:00:00.000Z and 23:59:59.999Z UTC before calling this endpoint.
Response highlights
external_amount_minorcurrency_codeidempotency_keyremote_referencerequest_jsonresponse_jsonbalance_after_minoroperation_typefailure_reasonattempt_countnext_retry_at- nested
operator_user - nested
market, nullable
balance_after_minor is nullable and is extracted from wallet response balanceMinor or balance_minor when present.
operation_type is derived from the linked source: order_id means trade; redemption_item_id means resolution; an unlinked historical/internal row returns unknown.