---
title: "Update Orca liquidity"
method: POST
path: "/markets/creditbook/collateral/orca/update_liquidity"
tags: ["creditbook"]
---

# Update Orca liquidity

`POST /markets/creditbook/collateral/orca/update_liquidity`

Increase or decrease liquidity on an Orca CLMM collateral position while keeping the loan collateralized.

## Headers

- `Idempotent-Key` string, nullable

## Request body

- TxnManageOrcaLiquidityParams
  - `increase` boolean, required
  - `loan` string, required
  - `manageParams` ManageLiquidityParamsSchema, required — Params for managing Orca CLMM collateral liquidity (`manage_orca_liquidity`).
    - `assetIndexGuidance` integer[], required
    - `collateralIndex` integer, required
    - `liquidityAmount` integer, required
    - `transferParams` union, required — How a CLMM transfer/manage sizes the position: by liquidity or by explicit token amounts (externally-tagged: `{ "Liquidity": … }` / `{ "TokenAmounts": … }`).
      - object
        - `Liquidity` LiquidityParamsSchema, required — CLMM liquidity-management params (slippage bound), used by Orca/Raydium `manage_liquidity`.
          - `slippageToleranceBps` integer, required — Slippage tolerance, in basis points.
      - object
        - `TokenAmounts` TokenAmountsParamsSchema, required — Explicit token-amount params for a CLMM position (Raydium / token-amount mode).
          - `tokenAAmount` integer, required
          - `tokenBAmount` integer, required
  - `positionMint` string, required

## Response `200`

Serialized transaction message and signatures

- VersionedTransactionReturn — versioned txn return
  - `message` string, required — serialized message
  - `signatures` VersionedTransactionSignature[], required — serialized signatures
    - `publicKey` string, required — serialized message
    - `signature` string, required — serialized signatures

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `409` — Idempotency-Key reused with a different request body
- `500` — Internal server error

---

[API](https://skmtc.dev/loopscale/apis/loopscale-api.md) · [All operations](https://skmtc.dev/loopscale/apis/loopscale-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/loopscale/loopscale-api/revisions/531f64dbe09c/schema)
