v1

latestOpenAPI 3.1.02026-07-241653251.3 MB

Trade Strategy

Liquidate participants

Fully exits one or more participants from the Strategy by selling everything they currently hold. Asynchronous. No allocations or per-participant amount — zerohash reads each participant's current balance and sells whatever they hold.

post/strategies/{strategy_id}/liquidate

Path parameters

strategy_idstring uuid required

Unique identifier of the Strategy.

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

Example request

{
  "participants": [
    {
      "participant_code": "CUST01"
    }
  ]
}

Response

Operation accepted and queued for processing. Body is the Operation in its initial validating status. Poll GET /strategies/operations/{operation_id} or subscribe to webhooks to observe the terminal status. On idempotent re-submission the existing Operation is returned and the status code may be 200 instead.

Example response

{
  "message": {
    "id": "b1c2d3e4-f5a6-4789-bcde-f01234567890",
    "strategy_id": "b1c2d3e4-f5a6-4789-bcde-f01234567890",
    "request_id": "b1c2d3e4-f5a6-4789-bcde-f01234567890",
    "type": "enrollment",
    "status": "validating",
    "allocations": [
      {
        "underlying_currency": "BTC",
        "weight": "0.50"
      }
    ],
    "created_at": "2026-04-17T10:00:00Z",
    "updated_at": "2026-04-17T10:00:00Z"
  }
}