Actions33
- Order Actions
- Position Actions
- Account Actions
- Market Data Actions
Order → Place Market Order
AI-generatedSummary
Places a HIP-3 perpetual market order on the DEX configured in credentials. It fetches the asset’s mid price, adjusts the order price by the selected slippage tolerance, and submits an immediate-or-cancel order.
Inputs
- Asset Symbol (required) — Symbol without a DEX prefix, such as XYZ100; the node adds the DEX prefix from credentials.
- Side (required) — Buy / Long or Sell / Short.
- Size (required) — Order size in base asset units.
- Slippage % (required) — Maximum slippage tolerance used to set the order price from the current mid price; defaults to 0.5%.
- Reduce Only (required) — When enabled, the order can only reduce an existing position; defaults to false.
Output shape
One item per input item, with the exchange response in its JSON body.
The operation submits a signed exchange order. It errors if DEX metadata or a mid price is unavailable, or if the asset is not found on the configured DEX. With Continue On Fail enabled, an item contains an error field instead.