The WinkDex API provides developers with the most accurate estimate of bitcoin spot prices, accurately weighing price, volume and timeliness of the transactions among the largest qualified bitcoin exchanges.

API Versioning

Current API Version

$ curl -I ""
HTTP/1.1 302 FOUND
Date: Thu, 03 Jul 2014 03:53:06 GMT
Content-Type: text/html; charset=utf-8

The base URL of the WinkDex is All request URIs must be prefixed with the current version of the WinkDex API. The current version is v0, and will redirect to the current version.

User Agent

Setting your User-Agent with cURL

$ curl -H "User-Agent: my-winkdex-app" ""

We ask that you identify your application by setting a unique User-Agent header and sharing it with us.


Enabling Gzip

$ curl -H "Accept-Encoding: gzip" "" | gzcat

We strongly encourage you to set the Accept-Encoding header to allow Gzip. This will improve performance of your API requests by reducing the amount of data sent over the network.

Units of Time and Currency

The WinkDex API uses the following representations for currency and time:

US Dollars

Quantities of US Dollars are represented by an integer in units of pennies.

Date and Time

Timestamps returned by the API are encoded in ISO-8601 format. Parameters that accept timestamps may be formatted in ISO-8601 or UNIX timestamps.

Time Resolutions

The time series API format includes a resolution field denoting the timespan between points. This field may take the form of 10min, 3h, 1d, etc. The following suffixes are used per NIST’s recommendations.

suffix meaning
min minutes
h hours
d days

Rate Limiting

Rate limiting response

$ curl ""
{"type": "about:blank", "title": "Request was throttled. Expected available in 3 seconds."}

While authentication is currently not required to access the WinkDex API, we ask that you respect our Terms of Service and only send one API request per minute. We reserve the right to enforce this limit and exclude abusive API clients.


The /price endpoint allows you to query the WinkDex at a given time.

GET Request

Making a price request

$ curl ""

Query Parameters

Name Required Default Description
time No The server’s current time An ISO-8601 or UNIX timestamp

JSON Response

Sample response body

    "_links": {
        "self": {
            "href": "/api/v0/price"
    "price": 63984,
    "timestamp": "2014-07-16T22:47:00Z"
Name Description
price The value of the WinkDex at the requested time in 0.01 USD
timestamp The ISO-8601 timestamp for this price point

Time Series

The /series endpoint allows you to query WinkDex time series data.

GET Request

Making a time series request

$ curl ""

Query Parameters

Name Required Default Description
start_time No end_time - 6 months Beginning of time series query
end_time No current server time End of time series query

JSON Response

Sample response body

    "_links": {
        "self": {
            "href": "/api/v0/series?start_time=1404259586"
    "series": [
            "end_time": "2014-07-02T00:26:00Z",
            "resolution": "10min",
            "name": "winkdexUSD",
            "results": [
                    "exchanges": [
                    "price": 63969,
                    "timestamp": "2014-07-02T00:16:00Z"
            "start_time": "2014-07-02T00:06:00Z"
Name Description
series An array of time series objects

Time Series objects

Name Description
start_time ISO-8601 timestamp denoting beginning of time series
end_time ISO-8601 timestamp denoting end of time series
resolution time span between points in the time series
results array of data points

Data Points

Name Description
timestamp ISO-8601 timestamp for this data point
price Price of the WinkDex in integer pennies
exchanges Exchanges used to calculate WinkDex at this point in time. Learn more.

Error Responses

The WinkDex API may return the following HTTP status codes upon error:

Error Code Meaning
400 Bad Request
404 Not Found – No resources could be found for the given URL
405 Method Not Allowed – You sent a request with an invalid HTTP method
406 Not Acceptable – You requested an unsupported format
429 Too Many Requests
500 Internal Server Error
503 Service Unavailable


You can reach us for technical support at

API Use Policy

Last Updated September 30, 2014

WINKLEVOSS INDEX, LLC (“WI”) provides, at this time, its WINKDEXSM API on a limited basis in order to make WINKLEVOSS INDEXSM (“WINKDEX”) data available to others to use. Subject to the terms and conditions set forth herein, you may use the WINKDEX API to download and republish (with attribution) WinkDex data in your own website or application. We are thrilled and encourage users and developers to use our API to distribute data, including WINKDEX data.

The WINKDEX API can be found at, with documentation available at

Subject to the terms and conditions set forth here, you are free to access our WINKDEX data using our API up to one (1) time per minute. If you require greater access, please contact us to make appropriate arrangements.

If you are using the WINKDEX API, please e-mail us at to tell us how you are using the WINKDEX API. Our goal is to make it as easy and useful as possible, so your input helps us serve you. While this is not a requirement, it is meant to give better service to our users.

Additionally, as a condition of accessing our API, WI requires appropriate attribution to let your users know that the data is from WINKDEX. You can achieve this attribution in any of the following ways:

  1. Identifying “WINKDEX” in screen shots taken from the website;
  2. Providing a link back to our site (; or
  3. Including the following attribution (as relevant): “Data Provided by WINKDEXSM.

We are flexible on the form of attribution. If you have a different way you would like to identify the data coming from WINKDEX, please feel free to contact us, and we will work with you.

If you have any questions or concerns about providing attribution, please contact us, and we can make arrangements to address any concerns.

By accessing the WINKDEX API, you agree and acknowledge that the WINKDEX API is proprietary to WI and/or its licensors and is protected by applicable intellectual property laws.

WI may discontinue, terminate, suspend, or change any aspect of the WINKDEX API, or its availability to you, at any time without notice. You may use the WINKDEX API to provide WINKDEX data, however, the WINKDEX API and associated data may not be used for the development or benchmarking of another financial services product without express written agreement from WI or its licensors.

If you have any questions or would like more information about the WINKDEX API or would like to obtain a license to use the WINKDEX data for other uses, please feel free to contact us at