Trading

Place an options order

post/order

Request

  • Base URL: https://testnet-api.hypercall.xyz
  • URL: https://testnet-api.hypercall.xyz/order
  • Auth: HTTP bearer

Request body

builder_code_addressstring nullable

Optional builder code address for fee rebates

client_idstring nullable
combo_definitionobject nullable

Optional canonical definition for a combo not yet present in discovery. Its content-bound symbol must match the exact signed symbol field. Existing combos may omit this field; outright orders must omit it.

mmp_enabledboolean
nonceinteger required
pricestring required

Price as string (must match signed value exactly)

reduce_onlyboolean
route'best_execution' | 'book_only' | 'rfq_only'

Order routing preference for public order submission.

side'Buy' | 'Sell' required

Order side (buy or sell).

signaturestring required
sizestring required

Size as string (must match signed value exactly)

symbolstring required
tif'gtc' | 'ioc' | 'fok'

Time in force for orders.

walletstring required

Response

Order placed

filled_sizestring required

Amount filled so far

mmp_triggeredboolean

Whether MMP triggered this update

order_idinteger nullable

Exchange-assigned order ID

reasonstring nullable

Reason for rejection or cancellation

request_idstring nullable

Request ID for correlating this update with the original command. Populated from the triggering OrderActionMessage's request_id.

status'ACKED' | 'OPEN' | 'PARTIALLY_FILLED' | 'FILLED' | 'CANCELED' | 'REJECTED' required

Order update status (used in order update messages).

timestampinteger required

Timestamp in milliseconds

wallet_addressstring required

Wallet address

Changes

No recorded changes to this operation across all 1 revision of this API.