Wallets

Your ProphetX account has a single wallet that tracks your available balance, open exposure, and transaction history. All monetary values are in USD.

Checking your balance

GET /partner/v4/mm/get_balance

Response

{
  "data": {
    "balance": 1000.00,
    "gec_balance": 500.00,
    "matched_order_balance": 200.00,
    "unmatched_order_balance": 50.00,
    "unmatched_order_balance_status": "succeed",
    "unmatched_order_last_synced_at": "2026-08-10T14:12:40.307908108Z"
  }
}

Field	Description
`balance`	Your available cash balance.
`gec_balance`	Global Exposure Credit available on your account. See Exposure Credits below.
`matched_order_balance`	Funds currently locked in matched (filled) positions.
`unmatched_order_balance`	Funds reserved for open orders that have not yet been matched.
`unmatched_order_balance_status`	Sync status of the unmatched balance (`succeed` or `failed`).
`unmatched_order_last_synced_at`	Timestamp of the last successful unmatched balance sync.

Transaction history

GET /partner/v4/mm/get_transactions

Returns a paginated list of wallet transactions. Each entry covers one lifecycle event on an order — placement, match, settlement, cancellation, or commission.

Query parameters

Parameter	Type	Description
`next_cursor`	string	Cursor for pagination. Pass the `next_cursor` value from the previous response to get the next page. Omit for the first page.
`limit`	integer	Number of records to return. Defaults to `20`, max `1000`.
`from`	integer	Unix timestamp. Only return transactions created at or after this time.
`to`	integer	Unix timestamp. Only return transactions created at or before this time.
`market_id`	string	Filter to transactions on this market.
`trade_id`	string	Filter to transactions on this trade.
`event_id`	string	Filter to transactions on this event.
`transaction_type`	string	Filter on `transaction_type`. See transaction types below.

Response

{
  "data": {
    "transactions": [
      {
        "status": "Completed",
        "user_id": "550e8400-e29b-41d4-a716-446655440000",
        "transaction_type": "PAY",
        "transaction_sub_type": "OTHER",
        "amount": 150.00,
        "change": 150.00,
        "balance": 1150.00,
        "balance_before": 1000.00,
        "details": "550e8400-e29b-41d4-a716-446655440000",
        "market_id": "219",
        "event_id": "44285780",
        "trade_id": "abc123",
        "description": "...",
        "created_at": "2026-08-10T14:00:00Z"
      }
    ],
    "next_cursor": "..."
  }
}

Field	Description
`status`	The transaction's status: `Completed`, `Pending`, `Processing`, `Failed`, `Expired`, or `Invalid`.
`user_id`	Your participant ID.
`transaction_type`	What triggered this transaction. See transaction types below.
`transaction_sub_type`	Further classification of the transaction type.
`amount`	The unsigned magnitude of this transaction.
`change`	The signed change applied to your balance for this transaction.
`balance`	Your balance after this transaction.
`balance_before`	Your balance before this transaction.
`details`	The client-supplied transaction ID used when this transaction was created (idempotency key).
`market_id`	The market this transaction relates to.
`event_id`	The event this transaction relates to.
`trade_id`	The trade this transaction relates to, if any.
`description`	Human-readable detail.
`created_at`	When this transaction was created.
`next_cursor`	Cursor for the next page. Absent on the last page.

Transaction types

`transaction_type`	Description
`TRADE`	Funds moved when an order (or part of it) is matched.
`DEPOSIT`	Funds added to the wallet.
`PAY`	Payout credited when an order settles as a win.
`WITHDRAW`	Funds withdrawn from the wallet.
`REJECT_WITHDRAW`	A withdrawal request was rejected and the funds were returned.
`APPROVE_WITHDRAW`	A withdrawal request was approved and the payout was sent. This step doesn't change your balance — the funds were already deducted when the withdrawal was requested.
`REFUND`	An explicit refund issued on an order.
`CANCEL`	Reserved funds returned after an order was cancelled.
`ADJUSTMENT_REDUCE`	A manual/administrative balance reduction.
`COMMISSION`	Commission fee charged on a transaction.
`ADJUSTMENT_INCREASE`	A manual/administrative balance increase.
`VOID`	Funds returned after a market or order was voided.
`PUSH`	Stake returned with no profit or loss after a push (tie) result.

Exposure credits

Exposure credits are credit lines extended by ProphetX to select accounts. They are not funded by you and do not appear in your deposit history. Two types exist: Global Exposure Credit (GEC) and Loss Exposure Credit (LEC).

Global Exposure Credit (GEC)

GEC is a general-purpose credit balance usable across markets. If your account has been granted GEC, it appears as gec_balance in the get_balance response.

GEC is drawn down when you place orders and returned when those orders are cancelled or settled. If a refund exceeds the GEC spent on a position, the difference is returned as cash.

Loss Exposure Credit (LEC)

LEC is a credit line scoped to specific market positions rather than your account as a whole. It is market-type aware — moneyline, spread, and total positions each have independent LEC availability. LEC does not appear as a field in get_balance; its consumption is tracked per position internally.

Comparing GEC and LEC

	GEC	LEC
Scope	Account-wide	Per market position
Visible in `get_balance`	Yes (`gec_balance`)	No
Market type aware	No	Yes

Both credit types are granted at ProphetX's discretion. Contact your ProphetX account manager if you have questions about exposure credit eligibility.