Trades

The Trades page reports Mini App order activity and the operator fee share generated by those trades.

Dashboard path

Operator Dashboard → Operations → Trades

Required scope: trades:read

What operators can do

• filter by a UTC date range, defaulting to the first and last day of the current month
• filter orders by status
• filter by exact external user ID
• filter by exact market ID
• review order ID and executed trade ID
• inspect the compact market title/slug and dedicated Market ID column alongside side, outcome, status, and created time
• see Gross Trade and Net Trade as signed user cash flow alongside positive generated fees and operator earnings
• review current-page SUM footers for gross trade, net trade, generated fees, and operator earnings
• export all filtered rows to CSV or copy the current page as HTML
• receive market title, slug, and ID as separate market_title, market_slug, and market_id export columns
• choose visible columns and display 25, 50, or 100 rows per page

Summary cards

The page reads the same filtered GET /api/operator/trades result and shows:

• generated trade fees: summary.fee_external_amount_minor_total
• operator earnings: summary.operator_fee_external_amount_minor_total
• operator fee rate: summary.operator_fee_bps

Fee amounts use the authenticated operator's configured summary.currency_code, not Polynion Credits. The API derives each fee's historical operator-currency equivalent from the trade's external amount and Credits equivalent before summing it. All values are scoped to the authenticated operator and applied filters. The Generated Fees and Operator Earnings cards summarize all matching rows, not only the current page.

Gross Trade and Net Trade match User Portfolio Trade History accounting. Buys display as negative user cash flow and sells as positive. Sell gross reconstructs net wallet credit plus fee; buy net is gross debit less fee. Generated Fees and Operator Earnings retain positive reporting semantics.

Status filters

Supported order statuses are listed in /docs/reference/statuses.

Important operator states:

• processed: trade flow completed
• failed: no successful final execution exists
• manual_review: automatic recovery stopped
• compensation_pending: wallet debit happened and compensation/reversal follow-up may be required

Source API

The page reads GET /api/operator/trades.

Use this page for trade-fee reporting and user/order investigation. Use Balance Ops when the question is about an actual wallet debit, credit, reversal, retry, or manual-review trail.