Skip to main content
POST
/
v2
/
portfolios
/
{portfolioId}
/
rebalance
curl --request POST \
  --url 'https://api.glider.fi/v2/portfolios/a1b2c3d4/rebalance' \
  --header 'x-api-key: gldr_sk_your_api_key'

{
  "success": true,
  "data": {
    "operationId": "rebalance:a1b2c3d4:a1b2c3d4%3Amanual%3Areq_01JWZEE2MF30KVRMRX53N88VA4",
    "submittedAt": "2026-04-17T12:00:00.000Z"
  }
}
Dispatches a one-off rebalance run outside the portfolio’s schedule. Typical use cases: an end-user wants to re-target immediately to capture or hedge market volatility, or your UI exposes a “rebalance now” control. The endpoint returns 202 immediately with an operationId; poll GET /v2/portfolios/{portfolioId}/operations/{operationId} until the operation completes (state: completed, failed, or cancelled). To decide when (or whether) to surface a manual trigger, read nextDueAt and lastRebalanceAt from GET /v2/portfolios/{portfolioId} first.
  • Auth: x-api-key header (required)
  • Scope: portfolios:write
If a rebalance is still in progress for the portfolio, the response returns the same operationId and original submittedAt from the in-flight run. Treat operationId as an opaque token. Each portfolio has a cooldown between manual triggers. Calls that arrive too soon after the previous rebalance return 429 with a Retry-After header (in seconds) indicating when to retry. Returns 404 for portfolios your API key does not have access to — same response shape as a portfolio that doesn’t exist.
​
portfolioId
string
required
Portfolio identifier returned by POST /v2/enroll or GET /v2/portfolios.
Common error responses:
  • 401 when x-api-key header is missing or the key is invalid
  • 403 when the API key lacks the portfolios:write scope
  • 404 when the portfolio does not exist or your API key cannot access it
  • 429 when triggered too soon after the previous rebalance — see the Retry-After header
  • 500 on unexpected server errors
curl --request POST \
  --url 'https://api.glider.fi/v2/portfolios/a1b2c3d4/rebalance' \
  --header 'x-api-key: gldr_sk_your_api_key'

{
  "success": true,
  "data": {
    "operationId": "rebalance:a1b2c3d4:a1b2c3d4%3Amanual%3Areq_01JWZEE2MF30KVRMRX53N88VA4",
    "submittedAt": "2026-04-17T12:00:00.000Z"
  }
}