Technical Docs

Underlying Asset Data

Each underlying asset supported by YieldBlox has a set of protocol-specific data stored in the pool accounts data entries.

Data Entries:

Interest Accrual Tracker Account

Address of the account that tracks interest accrual for the underlying account.

`{Underlying Asset Issuer Key}{Underlying Asset Overlap Key}{First 9 characters of underlying asset}_Tracker`

`{Interest Accrual Tracker Account Public Key}`

Interest Data

`{Underlying Asset Issuer Key}{Underlying Asset Overlap Key}{First 9 characters of underlying asset}_Interest`

`{Base Interest Rate}_{Interest Rate Slope 0}_{Interest Rate Slope 1}_{Interest Rate Slope 2}_{Interest Rate Slope 3}_{Interest Rate Threshold 1}_{Interest Rate Threshold 2}_{Interest Rate Threshold 3}`

- Base Interest Rate: Base interest rate constant in the interest rate equation (see math). Multiplied by 100 before being encoded.
- Interest Rate Slope 0: Interest rate slope when below the first interest rate threshold. Multiplied by 10 before being encoded.
- Interest Rate Slope 1: Interest rate slope when above the first interest rate threshold. Multiplied by 10 before being encoded.
- Interest Rate Slope 2: Interest rate slope when above the second interest rate threshold. Multiplied by 10 before being encoded.
- Interest Rate Slope 3: Interest rate slope when above the third interest rate threshold. Multiplied by 10 before being encoded.
- Interest Rate Threshold 1: If the utilization rate is above this threshold Interest Rate Slope 1 kicks in. Multiplied by 100 before being encoded.
- Interest Rate Threshold 2: If the utilization rate is above this threshold Interest Rate Slope 2 kicks in. Multiplied by 100 before being encoded.
- Interest Rate Threshold 3: If the utilization rate is above this threshold Interest Rate Slope 3 kicks in. Multiplied by 100 before being encoded.

Asset Loan-to-Value Ratio

Loan to value ratio for the underlying asset, used to calculate (health factors)[../user-docs/lending-borrowing/health-factors.md].

`{Underlying Asset Issuer Key}{Underlying Asset Overlap Key}{First 9 characters of underlying asset}_LTV`

`{Underlying Asset Loan-to-Value Ratio}`

- Loan to Value: Used in the health factor equation, loan to value ratio for the underlying asset. Multiplied by 100 before being encoded.

Fee Data

Data pertaining to fees related to the underlying asset.

`{Underlying Asset Issuer Key}{Underlying Asset Overlap Key}{First 9 characters of underlying asset}_Fee`

`{Liquidation Incentive}_{Liquidation Fee}_{YBX Fee Allocation}_{Withdrawal Fee}`

- Liquidation Incentive: Used in liquidations. This is the 'discount' the liquidator receives on the collateral they withdraw when they repay a loan. Multiplied by 100 before being encoded.
- Liquidation Fee: Used in liquidations. This is the portion of the liquidation incentive that is paid to the escrow pool. Multiplied by 100 before being encoded.
- YBX Fee Allocation: Percent of interest rate fees that are used to repurchase YBX. Multiplied by 100 before being encoded.
- Withdrawal Fee: Fee for withdrawing from the protocol. Multiplied by 100 before being encoded.

Allocation Data

Data pertaining to the ybx issuance allocation for assets

`{Underlying Asset Issuer Key}{Underlying Asset Overlap Key}{First 9 characters of underlying asset}_Allocation`

`{Collateral Incentive Allocation}_{Liability Incentive Allocation}`

- Collateral Incentive Allocation: Percent of YBX incentive issuance that is allocated to users who collateralize this asset. Multiplied by 100 before being encoded.
- Liability Incentive Allocation: Percent of YBX incentive issuance that is allocated to users who borrow this asset. Multiplied by 100 before being encoded.

Price Feed Data

Data pertaining to the price feeds used to track the price of underlying assets

`{Underlying Asset Issuer Key}{Underlying Asset Overlap Key}{First 9 characters of underlying asset}_Exchange`

`{Exchange Primary}_{Binance}_{Coinbase}_{FTX}_{Asset Ticker}`

- Exchange Primary: Denotes whether the preferred price for the asset is centralized exchange prices or the Stellar DEX. 1 for exchange primary, 0 for DEX primary.
- Binance: Denotes whether Binance is used as an oracle price source for this asset. 1 for yes 0 for no.
- Coinbase: Denotes whether Coinbase is used as an oracle price source for this asset. 1 for yes 0 for no.
- FTX: Denotes whether FTX is used as an oracle price source for this asset. 1 for yes 0 for no.
- Underlying asset ticker: The ticker used in price feed API calls.