Top up participants

Adds fiat to one or more existing Traders' positions and buys proportionally to the supplied allocations. Asynchronous. Idempotent on (strategy_id, X-REQUEST-ID).

post/strategies/{strategy_id}/top-up

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

{
  "allocations": [
    {
      "underlying_currency": "BTC",
      "weight": "0.50"
    }
  ],
  "participants": [
    {
      "participant_code": "CUST01",
      "amount": "5000.00"
    }
  ]
}

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"
  }
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.