> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hubra.app/llms.txt
> Use this file to discover all available pages before exploring further.

# POST /unstake

> Build an unsigned unstake transaction. Routes by strategy + kind.

```http theme={null}
POST https://hubra.app/api/v1/unstake
```

Build an unsigned unstake transaction. The route depends on `strategy` and `kind`:

| Strategy              | `deactivate`                                     | `instant`                                                                              | `slow`                                                                                   |
| --------------------- | ------------------------------------------------ | -------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
| `sol-native-stake`    | `StakeProgram.deactivate` (epoch-bounded \~2.5d) | Sanctum `depositStake` (active stake → SOL immediately)                                | —                                                                                        |
| `sol-liquid-stake`    | —                                                | Sanctum swap raSOL → SOL via routed liquidity                                          | Sanctum `withdrawStake` (raSOL → native stake account, then standard epoch deactivation) |
| `sol-leveraged-stake` | —                                                | Burn raSOL Max LP → raSOL via the rasol-max SDK (vault-idle or MarginFi flash bracket) | —                                                                                        |
| `usdc-earn`           | —                                                | Voltr direct-withdraw (no cooldown, no fee)                                            | —                                                                                        |

The returned `transaction` is base64 unsigned bytes. Sign and broadcast via [`POST /api/v1/broadcast`](/developer/endpoints/broadcast).

***

## Request

```bash theme={null}
curl -X POST https://hubra.app/api/v1/unstake \
  -H 'Content-Type: application/json' \
  -d '{
    "strategy":      "sol-native-stake",
    "wallet":        "<your-wallet>",
    "stakeAccount":  "<your-stake-account>",
    "kind":          "deactivate"
  }'
```

| Field           | Type                                  | Required    | Description                                                                                                                                        |
| --------------- | ------------------------------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `strategy`      | `string`                              | yes         | One of `sol-native-stake`, `sol-liquid-stake`, `sol-leveraged-stake`, `usdc-earn`.                                                                 |
| `wallet`        | `string`                              | yes         | Solana wallet pubkey.                                                                                                                              |
| `kind`          | `"deactivate" \| "instant" \| "slow"` | yes         | The unstake mode. See the matrix above for valid combinations. `sol-leveraged-stake` accepts only `instant`.                                       |
| `amount`        | `string`                              | conditional | Required except for `usdc-earn` with `isWithdrawAll: true`. For `sol-leveraged-stake`, this is the **raSOL Max LP** to burn (decimal, 9 decimals). |
| `stakeAccount`  | `string`                              | conditional | Required for all `sol-native-stake` calls. The active stake account returned by your earlier `/stake` call.                                        |
| `isWithdrawAll` | `boolean`                             | optional    | Valid only for `usdc-earn`. When `true`, withdraws the full vault position regardless of `amount`.                                                 |
| `outputAsset`   | `"raSOL" \| "SOL"`                    | optional    | Valid only for `sol-leveraged-stake` (default `"raSOL"`). `"SOL"` attaches a `next` step that converts the resulting raSOL → SOL. See below.       |

***

## Response shapes

The response shape mirrors `/stake`: `transaction` (base64 unsigned), `hubra_token` (required at `/broadcast`), plus route metadata.

### Sanctum-routed kinds

For `sol-native-stake instant`, `sol-liquid-stake instant`, and `sol-liquid-stake slow`:

```json theme={null}
{
  "strategy":      "sol-liquid-stake",
  "kind":          "instant",
  "transaction":   "<base64 unsigned tx>",
  "hubra_token":   "<token>",
  "route":         "sanctum",
  "sanctumKind":   "token",
  "sanctum_order": { "...": "..." },
  "signers":       ["<your-wallet>"]
}
```

`sanctumKind` varies by route:

| Strategy + kind            | `sanctumKind`   |
| -------------------------- | --------------- |
| `sol-liquid-stake instant` | `token`         |
| `sol-liquid-stake slow`    | `withdrawStake` |
| `sol-native-stake instant` | `depositStake`  |

Forward `hubra_token`, `sanctumKind`, and `sanctum_order` to `/broadcast`.

### Voltr-routed (`usdc-earn instant`)

```json theme={null}
{
  "strategy":    "usdc-earn",
  "kind":        "instant",
  "transaction": "<base64 unsigned tx>",
  "hubra_token": "<token>",
  "route":       "voltr",
  "signers":     ["<your-wallet>"]
}
```

Broadcast via `route: "rpc"`.

### Plain native deactivate (`sol-native-stake deactivate`)

```json theme={null}
{
  "strategy":    "sol-native-stake",
  "kind":        "deactivate",
  "transaction": "<base64 unsigned tx>",
  "hubra_token": "<token>",
  "signers":     ["<your-wallet>"],
  "notes":       "Stake becomes withdrawable after the deactivation epoch (~2.5 days). Then call /api/v1/withdraw."
}
```

No Sanctum or Voltr involvement. Broadcast via `route: "rpc"`. After the deactivation epoch passes, call [`POST /api/v1/withdraw`](/developer/endpoints/withdraw) to close the stake account and pull SOL back.

### Leveraged (`sol-leveraged-stake instant`)

Burns raSOL Max LP (`amount`) and pays out **raSOL**. Routes through the rasol-max SDK's dual path — `path` tells you which ran:

* `vault-idle` — one instruction, when the vault holds enough idle raSOL.
* `flash-bracket` — 8–10 instructions + an address-lookup-table, deleveraging your slice through a MarginFi flashloan. The first redemption per wallet lazily initialises a MarginFi account (\~0.005 SOL one-shot rent), flagged by `initializedMarginfiAccount`.

```json theme={null}
{
  "strategy":                    "sol-leveraged-stake",
  "kind":                        "instant",
  "outputAsset":                 "raSOL",
  "transaction":                 "<base64 unsigned tx>",
  "hubra_token":                 "<token>",
  "route":                       "rpc",
  "path":                        "flash-bracket",
  "burnedLpLamports":            "19500000",
  "expectedPayoutRasol":         "0.019485797",
  "expectedPayoutRasolLamports": "19485797",
  "initializedMarginfiAccount":  false,
  "receiptMint":                 "HUBsveNpjo5pWqNkH57QzxjQASdTVXcSK7bVKTSZtcSX",
  "receiptSymbol":               "raSOL",
  "signers":                     ["<your-wallet>"]
}
```

Broadcast via `route: "rpc"`.

#### Finishing to SOL (`outputAsset: "SOL"`)

The leveraged exit pays out raSOL, not SOL. Pass `outputAsset: "SOL"` to get the **same single LP → raSOL transaction** plus a ready-to-run `next` step for the raSOL → SOL conversion:

```json theme={null}
{
  "strategy":    "sol-leveraged-stake",
  "outputAsset": "SOL",
  "transaction": "<base64 unsigned tx>",
  "hubra_token": "<token>",
  "path":        "flash-bracket",
  "expectedPayoutRasol": "0.019414075",
  "next": {
    "description": "Broadcast THIS tx first, read the raSOL you actually received, then POST that amount here.",
    "endpoint": "/api/v1/unstake",
    "method":   "POST",
    "body": {
      "strategy": "sol-liquid-stake",
      "wallet":   "<your-wallet>",
      "amount":   "0.019414075",
      "kind":     "instant"
    }
  }
}
```

<Warning>
  The SOL leg is a **second signed transaction**, not atomic. Sanctum won't quote raSOL → SOL until the burned raSOL actually lands in your wallet. So: broadcast the withdraw, read the raSOL your wallet actually received, then fire the `next` call sized by that real balance — `next.body.amount` is only the build-time estimate.
</Warning>

***

## Examples

```bash theme={null}
# Native: epoch-bounded standard unstake
curl -X POST https://hubra.app/api/v1/unstake \
  -H 'Content-Type: application/json' \
  -d '{"strategy":"sol-native-stake","wallet":"<your-wallet>","stakeAccount":"<your-stake-account>","kind":"deactivate"}'

# Native: instant settlement to SOL via Sanctum
curl -X POST https://hubra.app/api/v1/unstake \
  -H 'Content-Type: application/json' \
  -d '{"strategy":"sol-native-stake","wallet":"<your-wallet>","stakeAccount":"<your-stake-account>","amount":"1.0","kind":"instant"}'

# Liquid: raSOL → SOL via Sanctum routing (instant)
curl -X POST https://hubra.app/api/v1/unstake \
  -H 'Content-Type: application/json' \
  -d '{"strategy":"sol-liquid-stake","wallet":"<your-wallet>","amount":"1.0","kind":"instant"}'

# Liquid: raSOL → stake account, then epoch deactivation (slow)
curl -X POST https://hubra.app/api/v1/unstake \
  -H 'Content-Type: application/json' \
  -d '{"strategy":"sol-liquid-stake","wallet":"<your-wallet>","amount":"1.0","kind":"slow"}'

# Leveraged: burn raSOL Max LP → raSOL
curl -X POST https://hubra.app/api/v1/unstake \
  -H 'Content-Type: application/json' \
  -d '{"strategy":"sol-leveraged-stake","wallet":"<your-wallet>","amount":"0.0195","kind":"instant"}'

# Leveraged: burn raSOL Max LP, then chain to SOL (returns a `next` step)
curl -X POST https://hubra.app/api/v1/unstake \
  -H 'Content-Type: application/json' \
  -d '{"strategy":"sol-leveraged-stake","wallet":"<your-wallet>","amount":"0.0195","kind":"instant","outputAsset":"SOL"}'

# USDC: full withdraw
curl -X POST https://hubra.app/api/v1/unstake \
  -H 'Content-Type: application/json' \
  -d '{"strategy":"usdc-earn","wallet":"<your-wallet>","kind":"instant","isWithdrawAll":true}'
```

***

## Errors

| Status | Slug                  | When                                                                                                                                                                     |
| ------ | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `400`  | `invalid_request`     | Missing fields, invalid `kind` for the strategy, `stakeAccount` missing for `sol-native-stake`, missing `amount` for `sol-leveraged-stake`, or an invalid `outputAsset`. |
| `404`  | `not_found`           | Unknown strategy key.                                                                                                                                                    |
| `502`  | `upstream_error`      | Sanctum / Voltr could not build the transaction.                                                                                                                         |
| `503`  | `service_unavailable` | Strategy is announced but not live.                                                                                                                                      |

***

## See also

<CardGroup cols={2}>
  <Card title="POST /quote" icon="magnifying-glass" href="/developer/endpoints/quote">
    Preview the output before unstaking.
  </Card>

  <Card title="POST /withdraw" icon="arrow-down" href="/developer/endpoints/withdraw">
    Complete a native deactivate.
  </Card>

  <Card title="POST /broadcast" icon="paper-plane" href="/developer/endpoints/broadcast">
    Submit the signed transaction.
  </Card>
</CardGroup>