Funded Order Data Model

BETA — SUBJECT TO CHANGE. This API is in beta and may change without notice.

These message shapes are shared by both OrderFundingService RPCs — the same FundedOrder you price with PreviewFundedOrder is what you place with CreateFundedOrder, and both return the same CostBreakdown.

FundedOrder

The supported order shape for on-demand funded placement. The initial rollout supports limit orders on binary event markets.

Field	Type	Required	Description
`market_slug`	`string`	Yes	Market identifier (slug).
`type`	`OrderType`	Yes	`ORDER_TYPE_LIMIT`. Limit orders only.
`price`	`MoneyAmount`	Yes	Limit price per share. `value` must be greater than `0` and less than `1`; `currency` must be `USD`, e.g. `{"value": "0.45", "currency": "USD"}`.
`quantity`	`string`	Yes	Positive number of shares as a base-10 decimal string.
`tif`	`TimeInForce`	Yes	`TIME_IN_FORCE_DAY`, `TIME_IN_FORCE_GOOD_TILL_CANCEL`, `TIME_IN_FORCE_GOOD_TILL_TIME`, or `TIME_IN_FORCE_FILL_OR_KILL`.
`good_till_time`	`Timestamp`	Conditional	Expiration timestamp. Required when `tif` is `TIME_IN_FORCE_GOOD_TILL_TIME`; must be omitted for all other time-in-force values.
`participate_dont_initiate`	`bool`	No	Post-only flag: the order may rest on the book but must not immediately match.
`intent`	`OrderIntent`	Yes	`ORDER_INTENT_OPEN` or `ORDER_INTENT_CLOSE` — whether the order opens or closes exposure.
`outcome_side`	`OutcomeSide`	Yes	`OUTCOME_SIDE_YES` or `OUTCOME_SIDE_NO`.
`action`	`OrderAction`	Yes	`ORDER_ACTION_BUY` or `ORDER_ACTION_SELL`.
`manual_order_indicator`	`ManualOrderIndicator`	Yes	`MANUAL_ORDER_INDICATOR_MANUAL` for human-entered orders, `MANUAL_ORDER_INDICATOR_AUTOMATED` for system-generated orders.

FOK orders and residual cash. A TIME_IN_FORCE_FILL_OR_KILL order can be durably accepted and then cancel with zero fill — past the automatic-reversal boundary. Its prefund stays in the participant account until you sweep it back.

MoneyAmount

Field	Type	Description
`value`	`string`	Base-10 decimal string, e.g. `"0.45"`.
`currency`	`string`	ISO 4217 code. Must be `USD`.

CostBreakdown

The prefund economics — returned by preview as a quote and by placement as the amounts actually applied. See the cost model for how each component is calculated.

Field	Type	Description
`collateral`	`MoneyAmount`	Worst-case collateral: `quantity × price` for buys, `quantity × (1 − price)` for sells.
`exchange_fee`	`MoneyAmount`	Estimated maximum exchange fee reserve for a full fill. Actual collection happens per execution and can be lower — see the fee schedule.
`vendor_fee`	`MoneyAmount`	Your vendor fee, echoed after validation.
`total_prefund`	`MoneyAmount`	`collateral + exchange_fee + vendor_fee` — the amount placement transfers.

Start Here

Partner Types & Eligibility

Get Connected

Onboard Participants

Funding

Monitor & Reconcile

FundedOrder

MoneyAmount

CostBreakdown

Used by

PreviewFundedOrder

CreateFundedOrder

​FundedOrder

​MoneyAmount

​CostBreakdown

​Used by

PreviewFundedOrder

CreateFundedOrder

FundedOrder

MoneyAmount

CostBreakdown

Used by