Lending

Lending advances funds from Vanish’s trading accounts into a one-time wallet and runs your own instructions against them in the same transaction - deploying into any lending provider you choose. Unlike a trade, the wallet is reused for the life of the position. A position is opened, then settled when you are done. There is no deposit step of its own - the funds are advanced by Vanish. Initiate still validates balances before it signs anything, and rejects with a 400 if there is insufficient balance for the token. Every request except the commit needs a signature - see Signing.

Lending endpoints are namespaced under /borrow in the API - the paths are the API’s own names, and the flow is the one described here.

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 own 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 lamports or SPL base units. Must be greater than `0`.
`loan_additional_sol`	Covers ATA creation in the wallet. It starts empty, so budget `2039280` lamports per token account the first time a position uses that token. Pass `0` once it holds enough.
`jito_tip_amount`	Only applied if the wrapped transaction exceeds Solana’s size limit and a two-transaction bundle is used - but always required, since it is part of the signed message either way.

Response

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

Vanish picks the route by transaction size: a signed transaction for you to broadcast, or - if it is too large - a two-transaction Jito bundle Vanish submits itself, in which case transaction is null and jito_bundle_id is set.

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":   0,
  "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 funds now sit in the one-time wallet and the position is open. Advancing more into the same position repeats these steps with the same smart_wallet_id.

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

Settle

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 - using your 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.
`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 and jito_bundle_id is always null - there is no bundle route here, so you always broadcast it yourself.

Broadcast and commit

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 a user holds a position in, with balances read live from 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. Filter on has_active_balance rather than a dust threshold of your own - it is true only when the wallet holds a non-SOL token with a positive balance.

If the on-chain balance lookup fails for a wallet, its balances comes back as an empty array rather than the whole call failing. Treat an empty list as unknown, not as a confirmed zero balance.

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

Position State

Next Steps

​Open a Position

​Settle

​Position State

​Next Steps

Open a Position

Settle

Position State

Next Steps