API Documentation
version - v1 beta

Post Methods

For flexible, fast, low cost queries


[post]

backtest

[post]

cointegration

[post]

copula

[post]

correlations

[post]

spread

[post]

zscores

Get Methods

Data done for you


[get]

backtest

[get]

cointegration

[get]

copula

[get]

correlations

[get]

credits used

[get]

prescanned

[get]

spread

[get]

zscores

API Route - zscores-get

/v1beta/cointegration

https://api.cryptowizards.net/v1beta/cointegration
Credits: 5

This GET method entails extracting data for analysis on your behalf. Note this carries a higher credits requirement. It is recommended to send in your own price data using POST endpoints if possible to increase the number of requests that can be made and at faster speeds.


The Z-Score is simply the spread converted to having a mean of zero and standard deviation of 1. On the platform, we simply refer to this as the spread. This endpoint provides the latest number. For example, if the Z-Score is -2.0, a trader might decide to go long on symbol 2 and short on symbol 1 (i.e. going long on the spread).


The rolling Z-Score is the same calculation but on a rolling window bases.


Parameters

symbol_1 (required)
i.e. BTCUSDT (if Binance) or BTC-USD (Coinbase) etc
symbol_2 (required)
i.e. BTCUSDT (if Binance) or BTC-USD (Coinbase) etc
exchange (required)
Binance, BinanceUs, ByBit, Coinbase, Dydx, Forex, Stocks
interval (required)
Daily, Hourly, Min5
period (required)
i.e. 365
spread_type
Dynamic, Ou, Static - (default Dynamic)
roll_w
Rolling window for rolling zscore
with_history
true returns results with extra historical data

GitHub Code Examples

Request Body (Curl)

curl -X GET "https://api.cryptowizards.net/v1beta/zscores?symbol_1=BTCUSDT\
&symbol_2=ETHUSDT&exchange=Binance&interval=Daily&period=365&spread_type=Static&roll_w=42\
&with_history=false" \
  -H "Content-Type: application/json" \
  -H "X-api-key: REPLACE_WITH_YOUR_API_KEY"

Response

{
  "data": {
    "zscore": -1.8319234794643324, // latest (normalised spread)
    "zscore_roll": -1.0849313351490961 // latest
  },
  "history": null
}

Response (with History)

{
  "data": {
    "zscore": -1.8371637299593213, // latest (normalised spread)
    "zscore_roll": -1.0888243025746907 // latest
  },
  "history": {
    "spread": [
      0.040914855946655226,
      -0.012394409112054916,
      ...
    ],
    "zscore": [
      0.3800204829367012,
      0.8366369696671615,
      ...
    ],
    "zscore_roll": [
      0.0,
      ...,
      -0.32123719298235043,
    ],
    "hedge_ratio": 0.26065945362141013,
    "half_life": 9.665886757988284,
    "hurst": 1.3818318260575893,
    "sigma0crossings": 7,
    "sigma2crossings": 2,
    "log_used": true,
    "last_zscore": {
      "zscore": -1.8371637299593213,
      "zscore_roll": -1.0888243025746907
    }
  }
}