REST Endpoints
# To gather a list of all Yield Platforms Supported (e.g. AAVEV2, COMPOUND, etc.) https://api.tiingo.com/tiingo/crypto-yield/platforms # To request meta data for all yield pools, use the following REST endpoint https://api.tiingo.com/tiingo/crypto-yield/pools # Yield Pool Tick Metrics https://api.tiingo.com/tiingo/crypto-yield/ticks # Yield Pool Historical OHLC Metrics https://api.tiingo.com/tiingo/crypto-yield/<poolCode>/metrics
Just remember, you will need your token in order to connect. Keep it safe.
Tiingo reads yield data directly on chain from various Cryptocurrency lending platforms such as AAVE, Compound, BenQi, Solend, and MakerDAO.
The Benefits of Tiingo Crypto Yield
- Pools and platforms easily queryable and yields and notional borrowed/supplied are aggregated in OHLCV and tick form.
- Complicated yield aggregations are all standardized into the Tiingo API for easy and accurate acquisition of data.
- Data is broken out into stable and variable yields if supported by the lending platforms.
- Notionals borrowed and supplied are provided.
- Data is updated constantly as changes are detect on blockchains.
- Multiple blockchains and networks are supported.
- Data can be downloaded in raw bulk form for enterprise customers..
To understand the relationship between Yield Lending Platforms and Yield Pools on the Tiingo API, think of the relationship of Exchanges and Cryptocurrencies.
Yield Platforms are similar to exchanges, and Yield Pools are similar to Cryptocurrencies in that they are mapped to specific Yield Platforms. E.g. "aavev2_usdc" Yield Pool is listed on the AAVE Yield Platform.
You can use the Yield Platform and Yield Pool meta endpoints to determine which pools belong on which platforms, then use the poolCode to query specific lending information from each Yield Pool via the metrics and ticks endpoints.
This endpoint returns the various Platforms supported by Tiingo. The platformCode acts as a unique identifier you can use to map Pools to.
To see a list of supported lending Platforms, use the following REST endpoints.
# To gather a list of all Yield Platforms Supported (e.g. AAVEV2, COMPOUND, etc.) https://api.tiingo.com/tiingo/crypto-yield/platforms
Response
Request
Examples
Field Name
JSON Field
Data Type
Description
Name
name
string
Formatted name of the Yield Platform.
Platform Code
platformCode
string
A unique identifier for the Yield Platform that can be used throughout the API to map Yield Pools to the given Platform. Similar to exchangeCode in the equity endpoints.
Network
network
string
The network this platform belongs to. E.g. ETH for mainnet, AVAX for Avalanche, SOL, for Solana.".
Yield pools are pools that belong to a specific Platform. You can treat poolCode similarly as cryptocurrency tickers.
Pool codes will be unique identifiers that you can query tick and metric data from.
To request meta data for a Yield Pools, use the following REST endpoints.
# To request meta data for all yield pools, use the following REST endpoint
https://api.tiingo.com/tiingo/crypto-yield/pools
# To request meta data for a specific yield pools, use the following REST endpoint
https://api.tiingo.com/tiingo/crypto-yield/pools?poolCodes=<poolCodes>
# To request meta data for a specific yield platforms, use the following REST endpoint
https://api.tiingo.com/tiingo/crypto-yield/pools?platformCodes=<platformCodes>
Response
Request
Examples
Field Name
JSON Field
Data Type
Description
Name
name
string
Name of the yield pool.
Pool Code
poolCode
string
A unique identifier mapped to this pool that can be used to query metric and tick data throughout the API.
Yield Platform
yieldPlatform
string
The Yield Platform this pool belongs to. The value will be the platformCode of the corresponding Yield Platform..
Borrow Rate Denimination
borrowRateDenomination
string
The cryptocurrency, or token, the borrow rate is denominated in.
Borrow Amount Denomination
totalBorrowDenomination
string
The cryptocurrency, or token, the borrow amount is denominated in.
Supply Rate Denimination
supplyRateDenomination
string
The cryptocurrency, or token, the supply rate is denominated in.
Supply Amount Denomination
totalSupplyDenomination
string
The cryptocurrency, or token, the supply amount is denominated in.
This endpoint allows you to query the latest metrics for the various yield pools in real-time as our processor reads changes from chain.
If you need historical values, please see the metrics ohlc endpoint below (Section 2.4.5).
To request yield pool metrics, use the following REST endpoints.
# Yield Pool Metric Ticks https://api.tiingo.com/tiingo/crypto-yield/ticks # Yield Pool Metric Ticks filtered by Pool Code https://api.tiingo.com/tiingo/crypto-yield/ticks?poolCodes=<poolCode>
Response
Request
Examples
Field Name
JSON Field
Data Type
Description
Date
date
datetime
The datetime this data pertains to. It will be a timestamp dependent upon the resampleFreq parameter. For example, if resampleFreq=5min, it will be in 5 min increments.
Pool Code
poolCode
string
A unique identifier mapped to this pool that can be used to query metric and tick data throughout the API.
Variable Borrow Rate
variableBorrowRate
float
The variable borrow rate (multiply by 100 for percentage).
Stable Borrow Rate
totalStableBorrowAmount
float
The stable borrow rate (multiply by 100 for percentage).
Variable Borrow Amount
totalVariableBorrowAmount
float
The amount borrowed subject to the variable borrow rate.
Total Borrow Amount
totalBorrowAmount
float
The total amount borrowed (total = stable amount + variable amount)
Supply Rate
supplyRate
float
The supply rate (multiply by 100 for percentage).
Total Supply Amount
totalSupplyAmount
float
The close total supply amount on the given date.
Available Liquidity Amount
availableLiquidityAmount
float
The amount of liquidity available that can be borrowed.
This endpoint allows you to query metrics for the various yield pools, and resample the data into OHLC values. Data can be resampled to as low as 1 minute bars, and the latest bar will constantly update throughout the minute.
If you need ticks, please see the ticks endpoint below (Section 2.4.5).
To request yield pool metrics, use the following REST endpoints.
# Yield Pool Metrics https://api.tiingo.com/tiingo/crypto-yield/<poolCode>/metrics # Yield Pool Metrics reasmpled to 1 minute bars historically https://api.tiingo.com/tiingo/crypto-yield/<poolCode>/metrics?startDate=2022-09-04&endDate=2022-09-05&resampleFreq=1min
Response
Request
Examples
Field Name
JSON Field
Data Type
Description
Date
date
datetime
The datetime this data pertains to. It will be a timestamp dependent upon the resampleFreq parameter. For example, if resampleFreq=5min, it will be in 5 min increments.
Open Variable Borrow Rate
openVariableBorrowRate
float
The open variable borrow rate on the given date.
High Variable Borrow Rate
highVariableBorrowRate
float
The high variable borrow rate on the given date.
Low Variable Borrow Rate
lowVariableBorrowRate
float
The low variable borrow rate on the given date.
Close Variable Borrow Rate
closeVariableBorrowRate
float
The close variable borrow rate on the given date.
Open Stable Borrow Rate
openStableBorrowRate
float
The open stable borrow rate on the given date.
High Stable Borrow Rate
highStableBorrowRate
float
The high stable borrow rate on the given date.
Low Stable Borrow Rate
lowStableBorrowRate
float
The low stable borrow rate on the given date.
Close Stable Borrow Rate
closeStableBorrowRate
float
The close stable borrow rate on the given date.
Open Variable Borrow Amount
openTotalVariableBorrowAmount
float
The open variable borrow amount on the given date.
High Variable Borrow Amount
highTotalVariableBorrowAmount
float
The high variable borrow amount on the given date.
Low Variable Borrow Amount
lowTotalVariableBorrowAmount
float
The low variable borrow amount on the given date.
Close Variable Borrow Amount
closeTotalVariableBorrowAmount
float
The close variable borrow amount on the given date.
Open Stable Borrow Amount
openTotalStableBorrowAmount
float
The open supply rate on the given date.
High Stable Borrow Amount
highTotalStableBorrowAmount
float
The high supply rate on the given date.
Low Stable Borrow Amount
lowTotalStableBorrowAmount
float
The low supply rate on the given date.
Close Stable Borrow Amount
closeTotalStableBorrowAmount
float
The close supply rate on the given date.
Open Total Borrow Amount
openTotalBorrowAmount
float
The open total borrow amount on the given date (total = stable amount + variable amount).
High Total Borrow Amount
highTotalBorrowAmount
float
The high total borrow amount on the given date (total = stable amount + variable amount).
Low Total Borrow Amount
lowTotalBorrowAmount
float
The low total borrow amount on the given date (total = stable amount + variable amount).
Close Total Borrow Amount
closeTotalBorrowAmount
float
The close total borrow amount on the given date (total = stable amount + variable amount).
Open Supply Rate
openSupplyRate
float
The open supply rate on the given date.
High Supply Rate
highSupplyRate
float
The high supply rate on the given date.
Low Supply Rate
lowSupplyRate
float
The low supply rate on the given date.
Close Supply Rate
closeSupplyRate
float
The close supply rate on the given date.
Open Total Supply Amount
openTotalSupplyAmount
float
The open total supply amount on the given date.
High Total Supply Amount
highTotalSupplyAmount
float
The high total supply amount on the given date.
Low Total Supply Amount
lowTotalSupplyAmount
float
The low total supply amount on the given date.
Close Total Supply Amount
closeTotalSupplyAmount
float
The close total supply amount on the given date.
Open Available Liquidity Amount
openAvailableLiquidityAmount
float
The open total available liquidity amount on the given date (amount that can be borrowed).
High Available Liquidity Amount
highAvailableLiquidityAmount
float
The high total supply amount on the given date (amount that can be borrowed).
Low Available Liquidity Amount
lowAvailableLiquidityAmount
float
The low total supply amount on the given date (amount that can be borrowed).
Close Available Liquidity Amount
closeAvailableLiquidityAmount
float
The close total supply amount on the given date (amount that can be borrowed).
Changes Detected
changesDetected
int32
The number of changes detected for any of the above variables on blockchain during the resample window.