Best Yield API
Developers > Best Yield > Best Yield API
To request full access to Idle Best Yield API please fill out this form.

Endpoints

Historical data

https://api.idle.finance/rates/[address]?[params]
[address]
[params]
Represents the underline token address:
  • DAI: 0x6b175474e89094c44da98b954eedeac495271d0f
  • USDC: 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48
  • USDT: 0xdac17f958d2ee523a2206206994597c13d831ec7
  • WBTC: 0x2260fac5e5542a773aa44fbcfedf7c193bc2c599
  • SUSD: 0x57ab1ec28d129707052df4df418d58a2d46d5f51
  • WETH: 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2
  • RAI: 0x03ab458634910aad20ef5f1c8ee96f1d6ac54919
  • FEI: 0x956f47f50a910163d8bf957cf5846d573e7f87ca
The query string params are:
  • start: filter results from a specific timestamp
  • end: filter results to a specific timestamp
  • isRisk (true|false): if true returns only results for risk-adjusted strategy, if false returns only results for Best Yield strategy
  • frequency: seconds between two records
  • order (asc|desc) : order results by timestamp
  • limit: limit results

Request examples

Return DAI historical data for risk-adjusted strategy from 22 July 2020 to 24 July 2020 ordered descending (1 day between records)
https://api.idle.finance/rates/0x6b175474e89094c44da98b954eedeac495271d0f?start=1595412616&end=1595581466&isRisk=true&frequency=86400&order=desc
Return the latest data for DAI Best Yield
https://api.idle.finance/rates/0x6b175474e89094c44da98b954eedeac495271d0f?isRisk=false&order=desc&limit=1

Authentication

For authentication, you need to use the Bearer authentication scheme. To use it, add the following header to your request:
Authorization -> Bearer <token> or add the API_KEY in the URL with the param ?api-key= (replace <token> with your API_KEY).