Beefy API
Last Update: August 2023
Last updated
Was this helpful?
Last Update: August 2023
Last updated
Was this helpful?
This page provides further details about the functionality and operation of Beefy's REST API, which powers our web application, dashboard and pages on third party sites.
You can access the API at , and the public repository is available on . The API is maintained under the MIT license, with further details available on the .
Our API offers a range of public endpoints covering the full selection of data required for our web app, backend and dashboard, as well as some third party services.
Endpoints developed for use by to display vaults' live characteristics and performance to our users.
Endpoints required or utilised by third party platforms to display information about Beefy or its products on their sites.
Please note that Beefy does not currently operate or maintain any subgraphs for our protocol.
You'll also find in that channel a collection of weekly reports on the breakdown of our $BIFI token across our different chains and vaults, which are lovingly prepared by core contributor EPETE.
Endpoints developed for use by to display information about the assets underlying our Beefy vaults to our users.
Endpoints developed for use by to display other information not relating to individual vaults.
Provides information on the addresses of the current configuration of wallets used to operate each blockchain used by the .
Provides information on all hosted by Beefy on the application, including live and historic boosts.
Endpoints developed for to display overarching information about the protocol.
Endpoints related to databarn, our historical data indexer. These endpoints are rate limited to maximum 5 requests per seconds. You may also want to try the for these endpoints.
Provides information required by in order to display Beefy vaults in their yield farming section.
Provides information required by in order to display BIFI's total supply and circulating supply on its site.
Our friends at Messari have developed a subgraph for our presence on BSC chain, which is available at , and on The Graph's (ID: QmfEtMEgjik9FSZdqAmp2DkNFG4M9TK4Go8uyCUj8EVxY6). Beefy has had no role in the development or maintenance of this subgraph. Please direct any questions or requests for assistance in relation to this subgraph directly to Messari.
For any readers seeking further information about Beefy and our protocol's performance, please head to the #📊-beefy-data channel in our . We'll be happy to answer any questions you may have there and you're welcome to inspect the history of our discussions in that channel for further background into our data work.
Describes all transactions for a given investor
^0x[a-fA-F0-9]{40}$
The investor timeline, list of all deposit and withdraw transaction for a given investor
The investor timeline, list of all deposit and withdraw transaction for a given investor
Returns the configuration accounted for in databarn
Only include produce for this chain
Include EOL (end of life) products, you probably never want to set this to true
false
List of all beefy products, vaults, boosts, governance vaults, etc.
List of all beefy products, vaults, boosts, governance vaults, etc.
Find one product configuration by chain and contract address
Only include products for this chain
The product contract address
^0x[a-fA-F0-9]{40}$
A product definition
Default Response
This endpoint returns snapshots of the api /tvls endpoints done every 15 minutes and can be used to request raw historical data but the time range must not exceede 1 week and the result will be truncated to 1000 elements. from_date
is inclusive and to_date
is exclusive to make is easier to use in loops
Only include products for this chain
The product contract address
^0x[a-fA-F0-9]{40}$
Inclusive date time to fetch data from, interpreted as utc tz
2023-01-01T00:00:00
Exclusive date time to fetch data to, interpreted as utc tz
2023-01-01T00:00:00
The raw tvl time series
[["2021-01-01T00:00:00",1234.34]]
The raw tvl time series
This endpoint is essentially used for charting and UIs as it provides a simple interface to get the most widely displayed time series.
share_to_underlying
is the ratio from share token to LP token (ppfs). underlying_to_usd
is the ratio from an LP token to USD.
Defines a bucket size and a time range like <bucket size>_<time range>
. For example, 1d_1M
means: 1 month of data aggregated by buckets of 1 day.
The price time series
[["2021-01-01T00:00:00","1000.0000012123","1000.0000012123","1000.0000012123","1000.0000012123"]]
The price time series
This endpoint can be used to request raw historical data but the time range must not exceede a week and the result will be truncated to 1000 elements. from_date
is inclusive and to_date
is exclusive to make is easier to use in loops
share_to_underlying
is the ratio from share token to LP token (ppfs). underlying_to_usd
is the ratio from an LP token to USD.
Inclusive date time to fetch data from, interpreted as utc tz
2023-01-01T00:00:00
Exclusive date time to fetch data to, interpreted as utc tz
2023-01-01T00:00:00
The raw price time series
[["2021-01-01T00:00:00",1234,"1000.0000012123"]]
The raw price time series