order

post

https://api.hyperliquid.xyzhttps://api.hyperliquid-testnet.xyz

/exchange

Place an order(s).

Body

application/json

Place an order(s).

nonceintegerRequired

Nonce (timestamp in ms) used to prevent replay attacks.

vaultAddressstring · min: 42 · max: 42Optional

Vault address (for vault trading).

Pattern: ^0[xX][0-9a-fA-F]+$

expiresAfterintegerOptional

Expiration time of the action.

Responses

200

Response for order placement.

application/json

422

Failed to deserialize the JSON body into the target type

text/plain

post

/exchange

HTTPcURLJavaScriptPython

POST /exchange HTTP/1.1
Host: api.hyperliquid.xyz
Content-Type: application/json
Accept: */*
Content-Length: 262

{
  "action": {
    "type": "order",
    "orders": [
      {
        "a": 1,
        "b": true,
        "p": "text",
        "s": "text",
        "r": true,
        "t": {
          "limit": {
            "tif": "Gtc"
          }
        },
        "c": "text"
      }
    ],
    "grouping": "na",
    "builder": {
      "b": "text",
      "f": 1
    }
  },
  "nonce": 1,
  "signature": {
    "r": "text",
    "s": "text",
    "v": 27
  },
  "vaultAddress": "text",
  "expiresAfter": 1
}

{
  "status": "ok",
  "response": {
    "type": "order",
    "data": {
      "statuses": [
        {
          "resting": {
            "oid": 1,
            "cloid": "text"
          }
        }
      ]
    }
  }
}