Market Operations - Kamino Docs

A flat reference of every kamino-manager command that touches a Kamino lending market or reserve. For workflow guidance — when to use each command, what to set, why — see the Curator Markets tab.

Before running any command, complete the Installation & Setup guide. The CLI requires ADMIN, RPC, KLEND_PROGRAM_ID_MAINNET, and KLEND_PROGRAM_ID_STAGING in .env.

Conventions

Execution modes

Every command supports --mode <value>:

Mode	What it does
`inspect`	Prints a Solana Explorer URL where you can simulate the transaction in your browser
`simulate`	Runs simulation server-side and prints the result
`execute`	Signs with the admin keypair and lands the transaction
`multisig`	Outputs a base58-encoded transaction for submission to a Squads proposal

Multisig mode requires --multisig <SQUADS_PUBKEY> to identify the multisig.

Network selection

Flag	Target	Program ID env var
(none)	Mainnet	`KLEND_PROGRAM_ID_MAINNET`
`--staging`	Staging program on Solana mainnet	`KLEND_PROGRAM_ID_STAGING`
`--devnet`	Solana devnet	(Devnet program ID resolved from env)

Market lifecycle

`create-market`

Initialize a new LendingMarket account.

yarn kamino-manager create-market --mode execute

Flag	Required	Description
`--mode`	Yes	`inspect` / `simulate` / `execute` / `multisig`
`--multisig`	If `--mode multisig`	Pubkey of the multisig that will own the market
`--staging` / `--devnet`	No	Network selection

`update-lending-market-from-config`

Apply a full market config update from a JSON file.

yarn kamino-manager update-lending-market-from-config \
  --lending-market <MARKET_ADDRESS> \
  --lending-market-config-path ./configs/<MARKET>/market-<MARKET>.json \
  --mode execute

Flag	Required	Description
`--lending-market`	Yes	Market address
`--lending-market-config-path`	Yes	Path to the JSON config file
`--mode`	Yes	Execution mode

`update-lending-market-name`

Focused command to rename a market.

yarn kamino-manager update-lending-market-name \
  --lending-market <MARKET_ADDRESS> \
  --new-name "My Market" \
  --mode execute

Flag	Required
`--lending-market`	Yes
`--new-name`	Yes
`--mode`	Yes

`update-lending-market-owner`

Promote lending_market_owner_cached to active owner. Final step of the two-step ownership transfer.

yarn kamino-manager update-lending-market-owner \
  --lending-market <MARKET_ADDRESS> \
  --mode multisig \
  --multisig <NEW_OWNER_MULTISIG>

Flag	Required
`--lending-market`	Yes
`--mode`	Yes
`--multisig`	If `--mode multisig`

`download-lending-market-config`

Export the current market config to a JSON file (read-only).

yarn kamino-manager download-lending-market-config \
  --lending-market <MARKET_ADDRESS>

Saves to ./configs/<MARKET_ADDRESS>/market-<MARKET_ADDRESS>.json.

`download-lending-market-config-and-all-reserves-configs`

Download the market config plus every reserve’s config in a single call.

yarn kamino-manager download-lending-market-config-and-all-reserves-configs \
  --lending-market <MARKET_ADDRESS>

`get-market-or-vault-admin-info`

Query admin metadata (owner, cached owner, emergency council).

yarn kamino-manager get-market-or-vault-admin-info \
  --address <MARKET_ADDRESS>

Reserve lifecycle

`add-asset-to-market`

Add a new reserve to a market with an initial config.

yarn kamino-manager add-asset-to-market \
  --market <MARKET_ADDRESS> \
  --mint <TOKEN_MINT> \
  --mint-program-id TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA \
  --reserve-config-path ./configs/my_reserve_config.json \
  --mode execute

Flag	Required	Description
`--market`	Yes	Market address
`--mint`	Yes	Token mint address
`--mint-program-id`	Yes	`TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA` for SPL Token, `TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb` for Token-2022
`--reserve-config-path`	Yes	Path to the reserve config JSON
`--mode`	Yes	Execution mode

`update-reserve-config`

Apply a full reserve config update from a JSON file.

yarn kamino-manager update-reserve-config \
  --reserve <RESERVE_ADDRESS> \
  --reserve-config-path ./configs/<RESERVE>.json \
  --mode execute

Flag	Required
`--reserve`	Yes
`--reserve-config-path`	Yes
`--mode`	Yes

`update-reserve-config-debt-cap`

Focused update of just the borrow cap. Faster to review than a full config update.

yarn kamino-manager update-reserve-config-debt-cap \
  --reserve <RESERVE_ADDRESS> \
  --mode multisig \
  --multisig <SQUADS_PUBKEY>

Flag	Required
`--reserve`	Yes
`--mode`	Yes
`--multisig`	If `--mode multisig`

`download-reserve-config`

Export the current reserve config to a JSON file.

yarn kamino-manager download-reserve-config \
  --reserve <RESERVE_ADDRESS> \
  --output ./configs/<RESERVE_ADDRESS>.json

Flag	Required
`--reserve`	Yes
`--output`	No (defaults to a path under `./configs/`)

`simulate-reserve-apy`

Compute the live supply and borrow APY for a reserve from on-chain state.

yarn kamino-manager simulate-reserve-apy \
  --reserve <RESERVE_ADDRESS>

Oracles

`get-oracle-mappings`

List Scope, Pyth, and Switchboard oracle addresses for known mints.

yarn kamino-manager get-oracle-mappings

Use the output to populate tokenInfo.scopeConfiguration.priceFeed, tokenInfo.pythConfiguration.price, or tokenInfo.switchboardConfiguration.priceAggregator in a reserve config.

Farms

`get-reserve-farms-apy`

Reward APY for a reserve’s collateral and debt farms.

yarn kamino-manager get-reserve-farms-apy \
  --reserve <RESERVE_ADDRESS>

For farm initialization, funding, and emission configuration, use the KFarms tooling.

Reserve config schema

The reserve config JSON schema is documented at Reserve config reference. A starter file ships with klend-sdk: klend-sdk/configs/reserve_config_example.json Some fields in older example files (assetTier, multiplierSideBoost, multiplierTagBoost) are deprecated and ignored by the program. The canonical schema is in the reference page above.

Market config schema

The market config JSON schema is documented at Market config reference.

Workflow guides

These pages walk through the curator workflow that uses the commands above:

Create a market

create-market

Add reserves

add-asset-to-market

Configure oracles

get-oracle-mappings, tokenInfo setup

Transfer to multisig

update-lending-market-from-config, update-lending-market-owner

Updating reserves

update-reserve-config, update-reserve-config-debt-cap

Market settings

update-lending-market-from-config, update-lending-market-name

Vault Operations

Create and manage Kamino vaults

Installation & Setup

Review installation and configuration

​Conventions

​Execution modes

​Network selection

​Market lifecycle

​create-market

​update-lending-market-from-config

​update-lending-market-name

​update-lending-market-owner

​download-lending-market-config

​download-lending-market-config-and-all-reserves-configs

​get-market-or-vault-admin-info

​Reserve lifecycle

​add-asset-to-market

​update-reserve-config

​update-reserve-config-debt-cap

​download-reserve-config

​simulate-reserve-apy

​Oracles

​get-oracle-mappings

​Farms

​get-reserve-farms-apy

​Reserve config schema

​Market config schema

​Workflow guides

Create a market

Add reserves

Configure oracles

Transfer to multisig

Updating reserves

Market settings

​Next

Vault Operations

Installation & Setup

Conventions

Execution modes

Network selection

Market lifecycle

`create-market`

`update-lending-market-from-config`

`update-lending-market-name`

`update-lending-market-owner`

`download-lending-market-config`

`download-lending-market-config-and-all-reserves-configs`

`get-market-or-vault-admin-info`

Reserve lifecycle

`add-asset-to-market`

`update-reserve-config`

`update-reserve-config-debt-cap`

`download-reserve-config`

`simulate-reserve-apy`

Oracles

`get-oracle-mappings`

Farms

`get-reserve-farms-apy`

Reserve config schema

Market config schema

Workflow guides

Next