ZEzerohash
CLOB

Submit order

Changed on

Submit a new order to the CLOB.

post/orders/v1/insert_order

Request

  • Base URL
    https://api.cert.zerohash.com
  • URL
    https://api.cert.zerohash.com/orders/v1/insert_order
  • Auth
    API key in header X-SCX-API-KEY and API key in header X-SCX-PASSPHRASE

Headers

X-SCX-SIGNEDstring required

HMAC-SHA256 signature of the request, base64-encoded. See the Authentication guide for the exact signing formula.

X-SCX-TIMESTAMPstring required
Example:1678901234

Current Unix timestamp in seconds. Must be within 60 seconds of server time or the request is rejected.

Request body

OR
OR
OR
OR

Example request

{
  "account": "firms/F-PLAT01/accounts/CUST01-customlabel",
  "user": "firms/F-PLAT01/users/CUST01",
  "cash_order_qty": "0",
  "clord_id": "1245567889",
  "good_till_time": "2025-09-12T18:07:22.155905574Z",
  "min_qty": "0",
  "order_capacity": "ORDER_CAPACITY_INDIVIDUAL",
  "order_qty": "200000",
  "price": "420000",
  "self_match_prevention_instruction": "SELF_MATCH_PREVENTION_INSTRUCTION_UNDEFINED",
  "session_id": "string",
  "side": "SIDE_BUY",
  "stop_price": "0",
  "symbol": "ETH/USD",
  "time_in_force": "TIME_IN_FORCE_GOOD_TILL_CANCEL",
  "trigger_method": "CONDITION_TRIGGER_METHOD_UNDEFINED",
  "type": "ORDER_TYPE_LIMIT"
}

Response

A successful response

order_idstring

The unique ID for the order generated by zerohash

Example response

{
  "order_id": "4RHK6N1G05ZF"
}

Changes

  • 47cf70ae701cRevision changes
    • breaking

      removed subschema #2: Limit Order subschema #3: Market to Limit Order subschema #4: Stop Order subschema #5: Stop Limit Order from the request body oneOf list

    • info

      added subschema #2: Limit Order subschema #3: Market to Limit Order subschema #4: Stop Order subschema #5: Stop Limit Order to the request body anyOf list