submit_order
Submit an order intent through pre-trade checks, record the pre-trade lock, and return an approval envelope before the order is sent.
Instructions
Submit an order intent through pre-trade and obtain an approval envelope. Mutates engine state and records the pre-trade lock; protected and disabled by default.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Optional caller-supplied unique order id; omit to have the server generate one | |
| mode | Yes | Required: immediate commits and settles at the order price and requires price, hold waits for execution reports | |
| side | Yes | buy or sell | |
| price | No | Limit price as an exact decimal string; required for immediate, omit for a market order in hold | |
| account | Yes | Account code | |
| baseAsset | Yes | Asset being bought or sold | |
| amountKind | Yes | quantity or volume | |
| quoteAsset | Yes | Asset used for pricing | |
| amountValue | Yes | Order size as an exact decimal string | |
| missingAccount | Yes | Required: create or reject; for an account that does not exist yet, create is refused for an agent with loosening_refused, and reject fails the submit instead |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| keyId | Yes | ||
| reasons | No | ||
| verdict | Yes | ||
| signedApproval | Yes |