Lending

A position moves part of the user’s balance into a one-time wallet and executes your instructions from it in the same transaction, so you can deploy into any lending provider. The wallet is provisioned once and stays with the position until you settle. This page covers opening a position and settling it. Every request except the commit needs a signature - see Signing.

Open a Position

Get a one-time wallet for the position

POST /borrow/smart-wallet

{
  "user_address":   "<user's Solana wallet address>",
  "protocol_label": "kamino-lend-v2",
  "timestamp":      "<unix milliseconds>",
  "user_signature": "<one-time wallet signing format>"
}

Response

{
  "smart_wallet_id": 4821,
  "address":         "7yQmA1p9K4xTb3dRfN2sVzE6uYhLc8jWq5vXgMn3v3Nf"
}

protocol_label is free-form text identifying the provider this position belongs to - any lending provider works, since your instructions are passed through unchanged. Store smart_wallet_id against the position: every later call identifies it by that, and the wallet is provisioned once, not per action.

Build your instructions

Assemble your provider’s deposit or open instructions into a single unsigned transaction, with the wallet address as the signer and fee payer. Base64-encode it as main_tx.Vanish appends its own instruction, signs the result, and simulates it before returning. A transaction that fails simulation is rejected rather than submitted.

Open the position

POST /borrow/initiate

{
  "smart_wallet_id":      4821,
  "user_address":         "<user's Solana wallet address>",
  "source_token_address": "<token mint>",
  "amount":               "250000000",
  "loan_additional_sol":  "2200000",
  "jito_tip_amount":      "10000",
  "main_tx":              "<base64-encoded unsigned transaction>",
  "timestamp":            "<unix milliseconds>",
  "user_signature":       "<lending signing format>"
}

Field	Guidance
`amount`	Amount to advance, in base units. Must be `> 0`; a short balance returns `400`.
`loan_additional_sol`	ATA creation. Budget `2039280` lamports per token account the first time the position uses it. Unused is refunded.
`jito_tip_amount`	Always required - it is part of the signed message. Only spent when Vanish submits a two-transaction bundle.

Response

{
  "action_id":      88213,
  "tx_id":          "<transaction signature>",
  "transaction":    "<base64-encoded signed transaction>",
  "jito_bundle_id": null
}

Vanish picks the route by transaction size. You either get a signed transaction to broadcast, or transaction is null and jito_bundle_id is set, meaning Vanish submitted a two-transaction bundle itself.

Broadcast if needed, then commit

Broadcast transaction if it is non-null; if jito_bundle_id is set instead, Vanish has already submitted it. Then commit either way:

POST /borrow/commit

{ "tx_id": "<transaction signature from /borrow/initiate>" }

Response

{
  "status":            "completed",
  "action_type":       "borrow",
  "already_processed": false,
  "balance_changes": [
    { "token_address": "<string>", "change": "<string>" }
  ],
  "vanish_fee":   "<lamports>",
  "tx_fee":       "5000",
  "completed_at": "2026-08-31T18:22:04.112Z"
}

/borrow/commit must be called for every lending action - success, failure, or expiry. Until it is, the action stays in a pending state. Lending returns the same statuses as a trade except rejected, which applies to deposits only - see Commit Status.

The position is now open. Advancing more into it repeats these steps with the same smart_wallet_id.

Reference: Create One-Time Wallet · Open Position · Commit Lending Action

Settle a Position

Settling returns the advanced funds to Vanish’s trading accounts, wrapped around your own withdraw or close instructions. Check Position State first.

Settle the position

Build main_tx exactly as when opening - unsigned, with the position’s one-time wallet as signer and fee payer - using your withdraw or close instructions.

POST /borrow/settle

{
  "smart_wallet_id":      4821,
  "user_address":         "<user's Solana wallet address>",
  "token_address":        "<token mint>",
  "amount":               "253000000",
  "loan_additional_sol":  "0",
  "cleanup_leftover_sol": true,
  "main_tx":              "<base64-encoded unsigned transaction>",
  "timestamp":            "<unix milliseconds>",
  "user_signature":       "<settle signing format>"
}

Field	Guidance
`amount`	Amount landing back in the wallet from your instructions. Must be greater than `0`.
`loan_additional_sol`	Covers ATA creation during the settle if the wallet is running low. Pass `0` when it already holds enough. Unused is refunded.
`cleanup_leftover_sol`	`true` returns any leftover SOL to Vanish’s trading accounts, credits it to the user, and closes the position. Set it only on the settle that fully unwinds the position - a partial withdrawal still needs the remaining SOL.

Settle always returns a signed transaction - there is no bundle route here, so you always broadcast it yourself.

Broadcast and commit

Broadcast the signed transaction through your RPC, then commit the action:

POST /borrow/commit

{ "tx_id": "<transaction signature from /borrow/settle>" }

The response matches the commit above with action_type set to settle. Once a settle with cleanup_leftover_sol is committed, the position’s status becomes closed.

Reference: Settle Position · Commit Lending Action

Position State

POST /borrow/positions returns every one-time wallet the user holds a position in, with balances read live from on-chain. It is read-only.

Response

[
  {
    "smart_wallet_id":    4821,
    "address":            "7yQmA1p9K4xTb3dRfN2sVzE6uYhLc8jWq5vXgMn3v3Nf",
    "protocol_label":     "kamino-lend-v2",
    "status":             "open",
    "created_at":         "2026-08-31T18:20:11",
    "closed_at":          null,
    "balances": [
      { "token_address": "<string>", "balance": "<string>", "program_id": "<string>" }
    ],
    "has_active_balance": true
  }
]

status is open until a settle with cleanup_leftover_sol is committed. has_active_balance is true only when the wallet holds a non-SOL token with a positive balance, so use it instead of setting your own dust threshold. Reference: Get Positions · Get Pending Lending Actions

Next Steps

Trading - Execute a private swap against a funded balance.
Error Handling - Commit statuses and recovering interrupted flows.

Getting Started

Guides

Health Check

Account

Fund Management

Trade

Commit Action

Lending

Open a Position

Settle a Position

Position State

Next Steps

​Open a Position

​Settle a Position

​Position State

​Next Steps

Open a Position

Settle a Position

Position State

Next Steps