Skip to main content
POST
/
batchPlaceOrder
Batch Place Orders
curl --request POST \
  --url https://api.hypereth.io/v2/hyperliquid/batchPlaceOrder \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "orders": [
    {
      "symbol": "<string>",
      "side": "buy",
      "type": "limit",
      "amount": "<string>",
      "price": "<string>",
      "flipPrice": "<string>",
      "clientOrderId": "<string>",
      "reduceOnly": true,
      "timeInForce": "GTC",
      "stopPrice": "<string>",
      "positionSide": "LONG",
      "orderExpiry": 123,
      "provisionOrRevert": true,
      "accountId": "<string>"
    }
  ]
}
'
{
  "success": true,
  "results": [
    {
      "index": 0,
      "success": true,
      "order": {
        "id": "1234567890",
        "clientOrderId": "0x1234567890abcdef1234567890abcdef",
        "symbol": "BTC",
        "side": "buy",
        "type": "limit",
        "status": "open",
        "price": "65000.0",
        "amount": "0.01",
        "filled": "0",
        "remaining": "0.01",
        "average": null,
        "reduceOnly": false,
        "positionSide": "LONG",
        "createdAt": 1710000000000,
        "dexProcessedTimestamp": 1710000000000
      }
    },
    {
      "index": 1,
      "success": false,
      "error": {
        "code": "insufficient_balance",
        "message": "Insufficient balance for order",
        "retriable": false
      }
    }
  ],
  "successCount": 1,
  "failureCount": 1,
  "dataTime": 1710000000000,
  "dexReceivedTimestamp": 1710000000900,
  "hyperethTimestamp": 1710000001000
}

Authorizations

X-API-KEY
string
header
required

Body

application/json
orders
object[]
required
Maximum array length: 10

Response

200 - application/json

Batch order response

success
boolean
results
object[]
successCount
integer
failureCount
integer
dataTime
integer<int64>
dexReceivedTimestamp
integer<int64>

Timestamp when HyperETH API server received this message from the venue (in milliseconds)

hyperethTimestamp
integer<int64>

Timestamp when HyperETH API server completed all processing before returning to client (in milliseconds)