Raw schema
{
"type": "object",
"properties": {
"accountProfile": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"eoa",
"safe"
]
},
"address": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$"
},
"chainId": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"kind",
"address",
"chainId"
],
"additionalProperties": false,
"description": "The Hyperliquid master account. `chainId` must be 1337, the signature chain id Hyperliquid pins for every L1 action."
},
"asset": {
"type": "string",
"pattern": "^[A-Za-z0-9]{1,32}$",
"description": "Perp symbol exactly as the venue names it, e.g. 'BTC', 'kPEPE'. Case-sensitive."
},
"side": {
"type": "string",
"enum": [
"BUY",
"SELL"
]
},
"size": {
"type": "string",
"pattern": "^(?:0|[1-9]\\d{0,15})(?:\\.\\d{0,14}[1-9])?$",
"description": "Order size in base units, e.g. '0.01'. At most szDecimals fractional digits for this perp."
},
"limitPrice": {
"type": "string",
"pattern": "^(?:0|[1-9]\\d{0,15})(?:\\.\\d{0,14}[1-9])?$",
"description": "Limit price. Must sit on the venue grid: at most 5 significant digits unless integer, and at most (6 - szDecimals) decimals."
},
"timeInForce": {
"default": "Gtc",
"description": "Gtc rests, Ioc fills-or-cancels, Alo posts only. There is no market order: name your own aggressive limit price with 'Ioc' instead.",
"type": "string",
"enum": [
"Gtc",
"Ioc",
"Alo"
]
},
"reduceOnly": {
"default": false,
"type": "boolean"
},
"takeProfitPrice": {
"description": "Optional reduce-only market take-profit trigger, bundled with grouping normalTpsl.",
"type": "string",
"pattern": "^(?:0|[1-9]\\d{0,15})(?:\\.\\d{0,14}[1-9])?$"
},
"stopLossPrice": {
"description": "Optional reduce-only market stop-loss trigger, bundled with grouping normalTpsl.",
"type": "string",
"pattern": "^(?:0|[1-9]\\d{0,15})(?:\\.\\d{0,14}[1-9])?$"
},
"tradingSigner": {
"description": "The address that will sign, when it is not the master account itself: a user-held approved API wallet. Declared, never derived.",
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$"
},
"vaultAddress": {
"description": "Trade on behalf of this vault or sub-account. A declared profile fact only.",
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$"
},
"client_ref": {
"type": "string",
"minLength": 1,
"maxLength": 128
}
},
"required": [
"accountProfile",
"asset",
"side",
"size",
"limitPrice"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}