Tech-related
How do you consider timestamps and time zones with regard to reference rates?
The Date follows the ISO datetime format: "YYYY-MM-DD HH:mm:ss" in UTC timezone.
Is it possible to call a specific Vinter API end point for a specific date?
Yes, it is possible!
To get data for a given symbol from a specific date, it is possible to add start_time and end_time parameters in the API request along a limit parameter. For example, to get daily bitcoin price for 2023-11-27, the API url would look like this:
https://www.vinterapi.com/api/v3/single_assets_daily/?limit=1&start_time=2023-11-27T00:00:00.000Z&end_time=2023-11-27T00:00:00.000Z&symbol=btc-usd-p-d
Naturally, do not forget to add your api key in header using Authorization parameter. This can be done bth for single and multi-assets indexes.
For more information, you can refer to our API documentation.
How do I find the asset pricing for a specific crypto asset?
The fastest way to get the asset pricing is via API. To do so, you need to fetch the correct Vinter API symbol (ex: "btc-usd-p-3-d"). Here below are the instructions to build the desired Vinter API symbol:
Define the "symbol" of the crypto asset. It is usually 3 to 5 letters long and is the same as the asset trading symbol you can see on most trading platforms. Example: Polygon is MATIC, hence you would call "matic-usd-p-5-d".
Determine the "currency" in which the asset is quoted. It is similar to the FX rate symbols. Example: Euro is EUR, hence you would call "btc-eur-p-d".
Find the right "suffix" used in the index calculations.
Check the Vinter index API symbol in the relevant index methodology (ex: "vndi-ddv-30-d").
Visit the Active Multi Assets endpoint page.
Click on the www.vinterapi.com link. To arrange the data in a human-readable way in your browser, we recommend using the extension JSONVue.
Look for the Vinter index API symbol, (ex: CTR + F "vndi-ddv-30-d").
Identify the suffix in the field "weights" (ex: from "mkr-usd-p-5-d", we can derive that the suffix is "-p-5-d").
Call for the desired Vinter API symbol (ex: arb-usd-p-d) with your API key. To fix the parameter, please visit the Single Assets Daily endpoint.
If you want to see which reference rate methodology is used for a given index/asset, you just have to identify the suffix and check it against this table.
What is the difference between btc-usd-p-5-d and btc-usd-p-d? What does p mean?
The suffixes "-p-5-d" and "-p-d" refer to two different time series calculated from two different computation methods. To get more details, check the Timeseries ID page.
The "p" stands for primary. For some reference rates, you can find a "c", which stands for complimentary. This is a value that is calculated in the same way but uses a different data feed.
Which API endpoint will give me the new constituents' weights?
The Active Multi Assets endpoint will give you the new rebalancing weights. For more details, check the section #how-does-rebalancing-works-if-we-are-integrated-via-api
Where can I see the live date for an index?
Index values are either "backtested" or "live".
To find the "Live Date", check the fields below. The first date in the past for which those fields are populated represents the Live Date. Before this date, all the index values are considered "backtested". Backtesting data is a simulation of the past performance of a similar strategy to the final index and is purely indicative of an index's past performance.
rebalance_weights
rebalance_values
current_values
current_weights
From a regulatory perspective, the listing date is when the Asset Manager becomes an official index user. The listing date is different from the live date. To get more details, please visit the section #what-is-the-difference-between-the-base-inception-first-value-live-launch-release-listing-date.
Which crypto exchanges are you sourcing the trade data from?
Our platform employs various asset pricing algorithms, and the selection of contributing crypto exchanges is contingent upon both the time series and the specific asset. To obtain a comprehensive list of exchanges associated with your index(es), follow these steps:
Identify the Vinter API symbol of your index in the relevant index methodology. (for ex: vnsn-moon-10-d)
Find the time series of the constituents.
Click on the Active Multi Asset endpoint.
Look for the Vinter API symbol (press CTR+F).
Identify all the constituents and their API symbol (for instance the corresponding BTC/USD API symbol is btc-usd-p-5-d).
Find the contributing exchanges for each constituent.
Click on the Active Single Asset endpoint.
Look for the constituent's API symbol (press CTR+F). In "contrib", you will find the real-time time series used to price the selected asset (for ex: btc-usd-p-r). Look for this new symbol to get the exhaustive list of crypto exchanges feeding our calculation engine.
If you need assistance, please reach out to support@vinter.co and we will be happy to help.
Last updated
