LogoLogo
  • Kaiko Knowledge Hub
  • Kaiko and Vinter
  • General
  • API
    • Overview
    • Multi Assets Indexes
      • Active Multi Assets
      • Multi Assets Parameters
      • Multi Assets Daily
      • Multi Assets Hourly
      • Multi Assets Real Time
      • Websocket - Multi Assets
    • Single Assets Reference Rates
      • Active Single Assets
      • Single Assets Daily
      • Single Assets Hourly
      • Single Assets Real Time
      • Websocket - Single Assets
      • Timeseries ID
    • Leveraged Indexes
      • Leveraged Single Assets
        • Leveraged Active Single Assets
        • Leveraged Single Assets Daily
      • Leveraged Multi Assets
        • Leveraged Active Multi Assets
        • Leveraged Multi Assets Daily
    • Vinter Taxonomy (VTAXO)
      • Active VTAXO
      • VTAXO
    • Net Asset Value (NAV)
      • Active Net Asset Value
      • Net Asset Value Daily
      • Net Asset Value Hourly
      • Net Asset Value Real Time
      • WebSocket - NAV
    • Staking Yield Reference Rates
      • Staking Tiers
        • On-Chain Tier
        • Staking Provider Tier
        • Exchange Tier
      • Active Staking Yields
      • Staking Yields Daily
    • API Requests Parameters
    • API Error Messages
  • FAQ
    • Onboarding
    • Product-related
    • Tech-related
Powered by GitBook
On this page
  • Important Information
  • API Changes
  • Index structure

Was this helpful?

Export as PDF
  1. API

Overview

This documentation provides information on the Vinter API, covering setup, usage, and understanding of features and endpoints. The content is divided into sections for ease of navigation.

The documentation includes:

  1. API endpoints

  2. Authentication methods

  3. Error handling

  4. Best practices

Code snippets and examples are provided to assist in integration.

For additional support or inquiries, contact your designated support agent.

Important Information

Vinter reference rates and index values are published between 0 and 5 minutes after the calculation of the index/reference rate.

When you query all Vinter endpoints without and parameters you receive the latest calculated price available at that point in time. This means that if you query the endpoint right after the calculation time you may receive the previous day's index/reference value.

For this reason, it is important to check the timestamp or created_at value to validate the date after fetching data from the API.

API Changes

The API may undergo incremental changes and any code consuming this API should be developed to accept:

  • The addition of new API endpoints

  • The addition of optional parameters to existing API requests

  • The addition of fields to existing API responses

Index structure

There are indexes containing one or multiple constituents. These two categories are:

  • single assets

  • multi assets

Single asset indexes track the value of a single asset e.g. BTC in USD, whereas multi assets indexes track the value of a portfolio with multiple assets e.g. BTC and XAU. The indexes are offered in three frequencies:

  • real-time (r)

  • hourly (h)

  • daily (d)

The last letter of the index name indicates its frequency. The btc-usd-p-h index is a single asset index with hourly (h) frequency. The vnby-bold1-d index is a multi asset index with daily (d) frequency.

Historical values

For the daily index series Vinter provides historical time-series. Values prior to the official start date of the index are only approximate values and should not be used for critical analysis. Historical values has a source_id of 0. This makes it easy to separate them from the official values.

API functionality

The core functionality of the Vinter API is to

  1. get symbols for all active index values.

  2. get current index values and metadata for each index.

By default, the API returns the most recent index value. You can control the number of records returned with the limit parameter. The API returns a maximum of 2000 records. If you are interested in the full history please contact support@kaiko.com

Try the API

You can use curl to try out the single assets hourly API

curl -H "Authorization: your_secret_api_key" https://www.vinterapi.com/api/v3/single_assets_hourly/?symbol=btc-usd-p-h 

In Python you can do this using the request library:

import requests 
url = "https://www.vinterapi.com/api/v3/single_assets_hourly/?symbol=btc-usd-p-h" 
headers = {"Authorization": your_secret_api_key} 
r = requests.get(url, headers=headers) 

Request API key

The active endpoint can be accessed without an API key, all other endpoints require an API key. You can request an API key by sending an email to support@kaiko.com

PreviousGeneralNextMulti Assets Indexes

Last updated 23 days ago

Was this helpful?