Redemption price oracle
The oracle allows you to get the latest ratio and calculate the Redemption Price by one of the formulas mentioned in the Redemption Price explanation.
Although, technically, it isn't a separate oracle contract but a method from Liquid Staking token contracts, we chose to present it as such, as logically it can be perceived as a service, and also for better discoverability.
What is Redemption Price?
The Redemption Price defines the exact amount of tokens that a user will get if he redeems its liquid staking after waiting its respective unbonding period, and it also defines the amount of Liquid Staking tokens that he receives when staking on the Ankr platform.
The formula is:
1 / ratio
when the user redeems their Liquid Staking tokens for the assets, i.e., unstakes their assets. This is why the user gets more assets than the number of the redeemed Liquid Staking tokens.1 * ratio
when the user stakes their assets. This is why the user gets less Liquid Staking tokens than the number of the staked assets.
All this is due to Liquid Staking tokens increasing in value overtime to the originally staked assets, which happens because ratio = TVL / (TVL + rewards)
.
Ankr's Redemption Price should be considered as the primary market, and market prices on Exchanges should be perceived as the second market.
Smart Contract API
Avalanche
ratio()
Returns the number of ankrAVAX tokens the user gets when staking their AVAX. Practically, the returned value is also ratio, since 1 * ratio
is effectively ratio
.
Parameters
The function returns:
- price (uint256) — ankrAVAX ratio.
Smart contracts
Examples
You can query for a ratio on the contract page by the links above, anytime.
Binance
ratio()
Returns the number of ankrBNB tokens the user gets when staking their BNB. Practically, the returned value is also ratio, since 1 * ratio
is effectively ratio
.
Parameters
The function returns:
- price (uint256) — ankrBNB ratio.
Smart contracts
Examples
You can query for a ratio on the contract page by the links above, anytime.
Ethereum
ratio()
Returns the number of ankrETH tokens the user gets when staking their ETH. Practically, the returned value is also ratio, since 1 * ratio
is effectively ratio
.
Parameters
The function returns:
- price (uint256) — ankrETH ratio.
Smart contracts
Examples
You can query for a ratio on the contract page by the links above, anytime.
Fantom
ratio()
Returns the number of ankrFTM tokens the user gets when staking their FTM. Practically, the returned value is also ratio, since 1 * ratio
is effectively ratio
.
Parameters
The function returns:
- price (uint256) — ankrFTM ratio.
Smart contracts
Examples
You can query for a ratio on the contract page by the links above, anytime.
Kusama
ratio()
Returns the number of aKSMb tokens the user gets when staking their KSM. Practically, the returned value is also ratio, since 1 * ratio
is effectively ratio
.
Parameters
The function returns:
- price (uint256) — aKSMb ratio.
Smart contracts
Examples
You can query for a ratio on the contract page by the links above, anytime.
Polkadot
ratio()
Returns the number of aDOTb tokens the user gets when staking their DOT. Practically, the returned value is also ratio, since 1 * ratio
is effectively ratio
.
Parameters
The function returns:
- price (uint256) — aDOTb ratio.
Smart contracts
Examples
You can query for a ratio on the contract page by the links above, anytime.
Polygon
ratio()
Returns the number of ankrMATIC tokens the user gets when staking their MATIC. Practically, the returned value is also ratio, since 1 * ratio
is effectively ratio
.
Parameters
The function returns:
- price (uint256) — ankrMATIC ratio.
Smart contracts
Examples
You can query for a ratio on the contract page by the links above, anytime.