---
title: "Set Target Balance Allocation"
method: POST
path: "/portfolio/target_balance_allocation"
tags: ["portfolio"]
---

# Set Target Balance Allocation

`POST /portfolio/target_balance_allocation`

## Request

- Base URL: `https://external-api.kalshi.com/trade-api/v2`
- URL: `https://external-api.kalshi.com/trade-api/v2/portfolio/target_balance_allocation`
- Auth: API key in header `KALSHI-ACCESS-KEY` and API key in header `KALSHI-ACCESS-SIGNATURE` and API key in header `KALSHI-ACCESS-TIMESTAMP`

Replaces the caller's target balance allocation across exchange indexes.
Percentages must total 100. Passing an empty allocations array disables automatic rebalancing.

## Request body

- SetTargetBalanceAllocationRequest
  - `allocations` TargetBalanceAllocationInput[], required
    - `exchange_index` integer, required: Exchange index that receives this percentage of sweepable balance
    - `percent` integer, required: Target percentage of sweepable balance for the exchange index
  - `resting_margin_reservation` 'none' | 'max' | 'sum': Collateral an automatic rebalance leaves behind for resting orders. `none` reserves no collateral for resting orders. `max` reserves the largest single market-side commitment. `sum` reserves the summed margin of every resting order.

## Response `200`

Target balance allocation updated successfully

- EmptyResponse: An empty response body

## Other responses

- `400`: Bad request - invalid input
- `401`: Unauthorized - authentication required
- `403`: Forbidden - insufficient permissions
- `500`: Internal server error

## Changes

- **2026-09-22** `4c03a1c6fdf8`: 1 info
  - added the new `none` enum value to the request property `resting_margin_reservation/allOf[#/components/schemas/RestingMarginReservation]/`
- **2026-09-01** `65a87ced9eec`: 1 info
  - added the new optional request property `resting_margin_reservation`
- **2026-08-18** `bd2f42622930`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/kalshi/apis/kalshi-trade-api-manual-endpoints/changes/portfolio/target_balance_allocation/post.md)

---

[API](https://skmtc.dev/kalshi/apis/kalshi-trade-api-manual-endpoints.md) - [All operations](https://skmtc.dev/kalshi/apis/kalshi-trade-api-manual-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/kalshi/apis/kalshi-trade-api-manual-endpoints/revisions/e6691cdd1915?raw)