---
title: "Withdraw capital"
method: POST
path: "/savings/capital/withdraw"
tags: ["Savings"]
---

# Withdraw capital

`POST /savings/capital/withdraw`

## Request

- Base URL: `https://api.altcointrader.co.za`
- URL: `https://api.altcointrader.co.za/savings/capital/withdraw`
- Auth: API key in header `X-API-KEY` and API key in header `X-TIMESTAMP` and API key in header `X-SIGNATURE`
- TypeScript: <https://skmtc.dev/altcointrader/apis/altcointrader-api/docs/savings/capital/withdraw/post.ts> (a function with typed inputs; its response is checked against the schema)

Withdraws (reclaims) contributed capital from the savings account for the given
currency. Capital is credited directly to the authenticated wallet.

Any accrued interest is automatically claimed at the same time and returned
in the response as `interest_claim` (omitted if no interest had accrued).

The savings account is resolved automatically - no account ID is required.

Requires the **savings** permission on the API key.

## Request body

- WithdrawCapitalRequest: Withdraw (reclaim) capital from the savings account for the given currency. The savings account is resolved automatically from the wallet associated with the API key - no account ID is required. Capital is returned to the authenticated wallet. Any accrued interest is automatically claimed at the same time.
  - `currency` string, required: Currency of the savings account to withdraw from.
  - `amount` string, required: Amount to withdraw as a decimal string (up to 8 decimal places).
  - `idempotency_key` string: Optional idempotency key. Duplicate requests with the same key return the original result.
  - `memo` string: Optional memo attached to this withdrawal.

## Response `200`

Capital withdrawn successfully.

- WithdrawCapitalResponse
  - `withdrawal` SavingsCapitalWithdrawal
    - `id` string
    - `savings_account_id` string
    - `currency` string
    - `amount` string: Withdrawn amount as a decimal string scaled to 8 decimal places.
    - `withdrawn_at` integer
  - `interest_claim` SavingsInterestClaim
    - `id` string
    - `savings_account_id` string
    - `currency` string
    - `amount` string: Interest claimed as a decimal string scaled to 8 decimal places.
    - `accrual_start_at` integer, nullable
    - `accrual_end_at` integer, nullable
    - `claimed_at` integer, nullable
  - `balance` SavingsBalance
    - `savings_account_id` string
    - `currency` string
    - `capital_contributions` string: Total capital deposited, as a decimal string scaled to 8 decimal places.
    - `claimed_interest` string: Total interest already claimed.
    - `unclaimed_interest` string: Interest accrued but not yet claimed.
    - `calculated_at` integer, nullable

## Other responses

- `400`: Invalid request parameters.
- `401`: Missing or invalid authentication headers.
- `403`: API key does not have permission for this action.
- `429`: Rate limit exceeded.
- `503`: Service temporarily unavailable.

---

[API](https://skmtc.dev/altcointrader/apis/altcointrader-api.md) - [All operations](https://skmtc.dev/altcointrader/apis/altcointrader-api/llms.txt) - [OpenAPI document](https://skmtc.dev/altcointrader/apis/altcointrader-api/revisions/eaa78e9afdc2?raw)