v1

latestOpenAPI 3.1.02026-07-241653251.3 MB
Trade Strategy

Create a Strategy

Creates a new Strategy under your platform. Synchronous. The request_id sent as the X-REQUEST-ID header is the idempotency key — re-submitting the same value returns the existing Strategy with its original id and created_at.

post/strategies

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

quoted_currencystring required

Currency the Strategy denominates amounts in.

metadataobject

Arbitrary JSON object for the platform to attach. Echoed back on reads; zerohash does not interpret the contents.

Example request

{
  "quoted_currency": "USD"
}

Response

Strategy created. Body is the created Strategy. On idempotent re-submission, the original Strategy is returned and the status code may be 200 instead.

Example response

{
  "message": {
    "id": "b1c2d3e4-f5a6-4789-bcde-f01234567890",
    "request_id": "b1c2d3e4-f5a6-4789-bcde-f01234567890",
    "quoted_currency": "USD",
    "metadata": {
      "owner_email": "ops@example.com",
      "internal_id": "STR-2026-Q2-001"
    },
    "created_at": "2026-04-17T10:00:00Z",
    "updated_at": "2026-04-17T10:00:00Z"
  }
}