Build rebalance operation

Create a rebalance to move funds between jupiter_lend and kamino (or refresh the same protocol). The response contains an unsigned transaction to sign and broadcast.

PATCH /yield/rebalance

Request body

Parameter	Type	Required	Description
`chain_name`	string	✅	Network (e.g. `solana`)
`amount`	string	✅	Decimal amount to move (`> 0`)
`wallet`	string	✅	User’s wallet public key
`asset`	string	✅	Token symbol (e.g. `USDC`)
`provider_out`	string		Withdraw leg: `jupiter_lend` or `kamino`
`provider_in`	string		Deposit leg: `jupiter_lend` or `kamino`
`provider`	string		When both legs use the same protocol, send only this field

Provide provider_in + provider_out, or a single provider when both legs are the same protocol.

Request example

curl --request PATCH \
  --url https://api.starkfi.io/yield/rebalance \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api_key>' \
  --data '{
    "chain_name": "solana",
    "wallet": "FmTGYpzX27fDqaiytXUdFVaphC5o68G61Q3uhVM2d8bm",
    "asset": "USDC",
    "amount": "0.01",
    "provider_out": "kamino",
    "provider_in": "jupiter_lend"
  }'

Expected response

{
  "statusCode": 200,
  "success": true,
  "status": "rebalance_yield_strategy_ok",
  "message": "Yield strategy rebalanced successfully",
  "data": {
    "mode": "single_transaction",
    "transaction": "<base64_unsigned_versioned_tx>"
  }
}

When instructions fit in one packet, mode is single_transaction and transaction holds the unsigned wire. Larger rebalances may return separate transactions — sign each and pass an array to yield broadcast if using StarkFi relay.

Sign and broadcast

Sign the returned wire(s), then broadcast on your RPC or optionally via POST /yield/broadcast.

Overview

Guides