Actions33
- Order Actions
- Position Actions
- Account Actions
- Market Data Actions
Position → Update Isolated Margin
AI-generatedSummary
Add or remove USD from the isolated margin for a specified side of a HIP-3 perpetual position. The node sends the margin update to Hyperliquid for the asset on the DEX configured in credentials.
Inputs
- Asset Symbol (required) — Asset symbol without the DEX prefix, such as XYZ100; the node adds the DEX prefix from credentials and resolves the asset in that DEX’s metadata.
- Position Side (required) — Choose Long or Short; sent as the position side for the margin update.
- Margin Delta (required) — USD amount to add when positive or remove when negative. Defaults to 0.
Output shape
A single JSON item per input item containing the Hyperliquid exchange response.
This operation submits an exchange action that changes isolated margin. The node fetches DEX metadata to resolve the asset before submitting it; failures are thrown unless Continue On Fail is enabled, in which case the item contains an error field.