place_perp_order
Places a simple perpetual futures order on HyperLiquid as a market or reduce-only limit order, specifying long or short, price, and contract size.
Instructions
Place a simple perp order on HyperLiquid without TP/SL. isMarket=true (default) is sent via /hl/create_order as a market order; isMarket=false sends a limit order at price via /hl/place_order, which the backend currently accepts only with reduceOnly=true.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"coin": "<coin>",
"isLong": "<isLong>",
"price": "<price>",
"size": "<size>"
},
"name": "place_perp_order"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| coin | Yes | Asset symbol | |
| size | Yes | Position size in contracts | |
| price | Yes | Price in USD ('0' with isMarket=true uses the mark price) | |
| apiKey | No | GDEX API key for AES encryption | |
| isLong | Yes | True for long, false for short | |
| isMarket | No | True for market (via create_order), false for limit | |
| accountRef | No | Connected account from gdex_connect. Supplies session key, wallet address, API key and session data so no secret is passed in chat | |
| reduceOnly | No | ||
| walletAddress | No | Control wallet address | |
| sessionPrivateKey | No | Session private key from sign-in |