Protocol
SB Core

Oracle

Price feeds, feed producers, and usage across the protocol

Feed Producers

Each SbAsset defines a set of authorised price feed producers — typically active witnesses or trusted accounts designated by the asset issuer. Any account can be authorised as a feed producer; governance is configured per-asset.

Price Calculation

  • The protocol takes the median of all valid, unexpired feed submissions for an asset
  • Feeds older than feed_lifetime_sec are considered stale and excluded from the median
  • A minimum number of valid feeds must exist before the protocol treats the price as active (configurable per asset)
  • If insufficient valid feeds exist, margin calls and force settlements are suspended for that asset

Price Feed Contents

FieldDescription
settlement_priceReference price used for margin calls and force settlement
maintenance_collateral_ratio (MCR)Minimum collateral ratio before margin call triggers
maximum_short_squeeze_ratio (MSSR)Maximum price premium at which margin call order executes
core_exchange_rateSBT-equivalent price used for fee payment in this asset

Feed Usage

PurposeFeed Field Used
Margin call triggersettlement_price vs current collateral ratio
Margin call order pricesettlement_price, MSSR, MCFR
Force settlement pricesettlement_price at settlement execution time
Fee payment conversioncore_exchange_rate

The feed_lifetime_sec value is configurable per asset. Stale or missing feeds suspend margin calls and settlements until valid feeds are restored.