Obligation

The Obligation account represents a user’s lending position, tracking all deposited collateral and borrowed assets. Each user can have multiple obligations per lending market.

tag

u64

Unique identifier tag for the obligation

last_update

LastUpdate

Last update tracking slot and staleness

lending_market

Pubkey

Parent lending market this obligation belongs to

owner

Pubkey

Authority that owns this obligation and can manage it

deposits

ObligationCollateral[8]

Array of deposited collateral positions (max 8 different assets)

Show ObligationCollateral fields

deposit_reserve

Pubkey

Reserve account where collateral is deposited

deposited_amount

u64

Amount of collateral tokens deposited

market_value_sf

u128

Market value of deposit in quote currency (scaled fraction)

borrowed_amount_against_this_collateral_in_elevation_group

u64

Amount borrowed against this specific collateral in elevation group

lowest_reserve_deposit_liquidation_ltv

u64

Lowest liquidation LTV among all deposited reserves

deposited_value_sf

u128

Total deposited value in quote currency (scaled fraction)

borrows

ObligationLiquidity[5]

Array of borrowed positions (max 5 different assets)

Show ObligationLiquidity fields

borrow_reserve

Pubkey

Reserve account from which liquidity is borrowed

cumulative_borrow_rate_bsf

BigFractionBytes

Cumulative borrow rate at time of last update (big fraction)

first_borrowed_at_timestamp

u64

Unix timestamp when this debt was first borrowed

borrowed_amount_sf

u128

Amount borrowed including accrued interest (scaled fraction)

market_value_sf

u128

Market value of borrowed amount in quote currency (scaled fraction)

borrow_factor_adjusted_market_value_sf

u128

Market value adjusted by borrow factor weight (scaled fraction)

borrowed_amount_outside_elevation_groups

u64

Amount borrowed outside of any elevation group

borrow_factor_adjusted_debt_value_sf

u128

Total debt value adjusted by borrow factors (scaled fraction)

borrowed_assets_market_value_sf

u128

Total borrowed assets market value without borrow factor adjustment (scaled fraction)

allowed_borrow_value_sf

u128

Maximum allowed borrow value based on deposits and LTV (scaled fraction)

unhealthy_borrow_value_sf

u128

Borrow value threshold at which position becomes liquidatable (scaled fraction)

elevation_group

Elevation group ID this obligation belongs to (0 = no elevation group)

num_of_obsolete_deposit_reserves

Count of deposits in obsolete reserves

has_debt

Boolean flag indicating if obligation has any outstanding debt

referrer

Pubkey

Referrer account eligible for referral fees

borrowing_disabled

Boolean flag disabling borrowing for this specific obligation

autodeleverage_target_ltv_pct

Target LTV percentage for autodeleverage operations

lowest_reserve_deposit_max_ltv_pct

Lowest max LTV percentage among all deposited reserves

num_of_obsolete_borrow_reserves

Count of borrows from obsolete reserves

highest_borrow_factor_pct

u64

Highest borrow factor percentage among all borrows

autodeleverage_margin_call_started_timestamp

u64

Unix timestamp when autodeleverage margin call started (0 = not marked)

obligation_orders

ObligationOrder[2]

Array of limit orders for automated position management

Show ObligationOrder fields

condition_threshold_sf

u128

Threshold value for order condition trigger (scaled fraction)

opportunity_parameter_sf

u128

Parameter defining order opportunity (e.g., amount to deleverage)

min_execution_bonus_bps

u16

Minimum execution bonus in basis points

max_execution_bonus_bps

u16

Maximum execution bonus in basis points

condition_type

Type of condition: Never (0), UserLtvAbove (1), UserLtvBelow (2), DebtCollPriceRatioAbove (3), DebtCollPriceRatioBelow (4), Always (5), LiquidationLtvCloserThan (6)

opportunity_type

Type of opportunity: DeleverageSingleDebtAmount (0), DeleverageAllDebt (1)

borrow_order

BorrowOrder

Active borrow order for this obligation

Show BorrowOrder fields

debt_liquidity_mint

Pubkey

Mint of the token to borrow

remaining_debt_amount

u64

Remaining amount to be filled

filled_debt_destination

Pubkey

Destination account for filled borrow amount

min_debt_term_seconds

u64

Minimum debt term in seconds required for fill

fillable_until_timestamp

u64

Unix timestamp until which order can be filled

placed_at_timestamp

u64

Unix timestamp when order was placed

last_updated_at_timestamp

u64

Unix timestamp of last order update

requested_debt_amount

u64

Original requested borrow amount

max_borrow_rate_bps

u32

Maximum borrow rate in basis points user is willing to pay

active

Boolean flag indicating if order is active

Key Health Metrics

Loan-to-Value (LTV)

Calculated as: borrow_factor_adjusted_debt_value / deposited_value

Health Status

Healthy: LTV < allowed LTV (can borrow more)
Unhealthy: LTV >= liquidation threshold (liquidatable)
Margin Call: Marked for autodeleverage

Remaining Borrow Capacity

Calculated as: allowed_borrow_value - borrow_factor_adjusted_debt_value

Constraints

Maximum 8 different collateral deposits
Maximum 5 different asset borrows
Maximum 2 obligation orders (limit orders)
Maximum 1 active borrow order

Account Size

The Obligation account has a fixed size of 1784 bytes (OBLIGATION_SIZE).

Common Operations

Deposit Collateral

Adds collateral to the deposits array, increasing deposited_value_sf and allowed_borrow_value_sf.

Borrow

Adds or increases a borrow in the borrows array, increasing borrowed_amount_sf and borrow_factor_adjusted_debt_value_sf.

Repay

Reduces borrowed amount, potentially removing the borrow entry if fully repaid.

Withdraw

Removes collateral, potentially closing the deposit position if fully withdrawn.

Liquidate

Liquidator repays part of debt and receives discounted collateral when position is unhealthy.

Instructions

State Accounts

Error Codes

Obligation

Obligation

Key Health Metrics

Loan-to-Value (LTV)

Health Status

Remaining Borrow Capacity

Constraints

Account Size

Common Operations

Deposit Collateral

Borrow

Repay

Withdraw

Liquidate

Build docs developers (and LLMs) love

Instructions

State Accounts

Error Codes

​Obligation

​Key Health Metrics

​Loan-to-Value (LTV)

​Health Status

​Remaining Borrow Capacity

​Constraints

​Account Size

​Common Operations

​Deposit Collateral

​Borrow

​Repay

​Withdraw

​Liquidate

Build docs developers (and LLMs) love

Obligation

Key Health Metrics

Loan-to-Value (LTV)

Health Status

Remaining Borrow Capacity

Constraints

Account Size

Common Operations

Deposit Collateral

Borrow

Repay

Withdraw

Liquidate