Raw schema
{
"type": "object",
"properties": {
"symbol": {
"description": "Base coin, e.g. BTC",
"maxLength": 20,
"minLength": 1,
"type": "string"
},
"side": {
"description": "buy = open or add to a long, sell = open or add to a short",
"enum": [
"buy",
"sell"
],
"type": "string"
},
"size_base": {
"description": "Size in the base coin (BTC, not USD); rounded down to the venue step. Get it from size_position",
"exclusiveMinimum": 0,
"type": "number"
},
"stop_loss": {
"description": "Required stop-loss, USD per coin: below entry for buys, above for sells. Or give stop_distance_pct",
"exclusiveMinimum": 0,
"type": [
"number",
"null"
]
},
"stop_distance_pct": {
"description": "Or the stop as a distance from the entry (trigger price, limit price or mark), 0.02 = 2%",
"exclusiveMaximum": 1,
"exclusiveMinimum": 0,
"type": [
"number",
"null"
]
},
"venue": {
"default": "hyperliquid",
"description": "Venue: sandbox, hyperliquid, okx, bybit or binance. Omitted: the agent's only venue, else hyperliquid if connected, else your only connected exchange, else the sandbox; or \"best\": the cheapest all-in venue (price plus fee) you may use and have the margin for",
"type": "string"
},
"order_type": {
"default": "market",
"enum": [
"market",
"limit"
],
"type": "string"
},
"price": {
"description": "Limit price, USD per coin (limit orders only)",
"exclusiveMinimum": 0,
"type": [
"number",
"null"
]
},
"leverage": {
"default": 5,
"description": "Leverage, e.g. 5 (the default); size_position's preview_args carries one your limits allow",
"maximum": 125,
"minimum": 1,
"type": "integer"
},
"take_profit": {
"description": "Optional take-profit, USD per coin",
"exclusiveMinimum": 0,
"type": [
"number",
"null"
]
},
"trigger_price": {
"description": "Optional: hold the order and open it at market only when the mark reaches this price (a breakout or a pullback), re-checked then; market orders only. Risk is computed from this price",
"exclusiveMinimum": 0,
"type": [
"number",
"null"
]
},
"trigger_valid_hours": {
"description": "With trigger_price: hours it waits before lapsing, 1-168 (default 24)",
"maximum": 168,
"minimum": 1,
"type": [
"integer",
"null"
]
},
"oco_with": {
"description": "Optional, for an entry that waits (trigger_price or a limit order): the request_id (req_…) of another waiting entry of yours, a trigger entry or an unfilled limit order, on any symbol or venue. One cancels the other: once either opens, the rest of the group is withdrawn (e.g. a buy above resistance or a sell below support)",
"maxLength": 64,
"pattern": "^req_[A-Za-z0-9_-]+$",
"type": [
"string",
"null"
]
},
"ladder_prices": {
"description": "Optional ladder entry: 2-5 limit prices, size_base split evenly across them, one stop-loss beyond all of them (stop_distance_pct counts from the farthest price); order_type limit, no price",
"items": {
"exclusiveMinimum": 0,
"type": "number"
},
"maxItems": 5,
"minItems": 2,
"type": [
"array",
"null"
]
},
"reason": {
"description": "Optional: why, in your words (up to 500 characters). The person sees it on the approval card and in history; other agents never do",
"maxLength": 500,
"type": [
"string",
"null"
]
},
"hold_hours": {
"description": "Optional: how long you expect to hold, in hours, to see funding and the round trip's cost (and, with venue \"best\", to choose by them)",
"exclusiveMinimum": 0,
"maximum": 2160,
"type": [
"number",
"null"
]
}
},
"required": [
"symbol",
"side",
"size_base"
],
"anyOf": [
{
"required": [
"stop_loss"
]
},
{
"required": [
"stop_distance_pct"
]
}
]
}