Collateral Factor

A fToken's collateral factor can range from 0-90%, and represents the proportionate increase in liquidity (borrow limit) that an account receives by minting the fToken. Generally, large or liquid assets have high collateral factors, while small or illiquid assets have low collateral factors.

If an asset has a 0% collateral factor, it can't be used as collateral (or seized in liquidation), though it can still be borrowed.

Unitroller

function markets(address fTokenAddress) view returns (bool, uint, bool)

• fTokenAddress: The address of the fToken to check if listed and get the collateral factor for.

• RETURN: (isListed, collateralFactorMantissa, isFtsed); isListed represents whether the Unitroller recognizes this fToken; collateralFactorMantissa, scaled by 1e18, is multiplied by a supply balance to determine how much value can be borrowed. The isFtsed boolean indicates whether or not suppliers and borrowers are distributed FTS tokens.

Solidity

Unitroller troll = Unitroller(0xABCD...);
(bool isListed, uint collateralFactorMantissa, bool isFtsed) = troll.markets(0x3FDA...);

Web3 1.0

const troll = Unitroller.at(0xABCD...);
const result = await troll.methods.markets(0x3FDA...).call();
const {0: isListed, 1: collateralFactorMantissa, 2: isFtsed} = result;