REST API

Macro & liquidity

The context in which the crypto market moves: rates, dollar, liquidity, indices, gold and oil, daily and intraday. All these routes are whole-market.

#Daily macro series

GET/v1/macrodata_type · macro
GET/v1/macro/seriesdata_type · macro_series
GET/v1/macro/historydata_type · macro_history

About twenty official American series, plus gold, split into eight categories. The first route returns the latest value of each; the second gives the catalogue; the third the history of one series, designated by ?series=.

CategorySeries
Foreign exchangeBroad dollar, emerging-market dollar, EUR/USD, USD/JPY
RatesFed funds, 2 year, 10 year, 30 year, and the 10 year − 2 year and 10 year − 3 month slopes
InflationCPI, PCE, 5 year and 10 year breakeven inflation rates
LiquidityM2, monetary base, Fed balance sheet, Treasury general account, overnight reverse repos
VolatilityVIX
EquitiesS&P 500, Nasdaq composite
EmploymentUnemployment rate, non-farm payrolls
CommoditiesGold, WTI crude oil
curl
# The catalogue of the series served
curl -H "X-API-KEY: $BYTNODE_KEY" "https://api.bytnode.com/v1/macro/series"

# The history of one series
curl -H "X-API-KEY: $BYTNODE_KEY" \
  "https://api.bytnode.com/v1/macro/history?series=DGS10&limit=90"
FieldTypeDescription
series_idstringThe identifier to pass in ?series=.
categorystringOne of the eight categories.
labelstringThe readable label of the series.
unitsstringThe unit of the value. It differs from one series to the next: never sum two series without reading it.
datestringThe date of the observation.
valuefloatThe value observed.

#Derived indicators

Four composite readings, computed on demand from the raw series and the price of Bitcoin.

GET/v1/macro/correlationsdata_type · macro_correlations

The rolling correlation of Bitcoin with the dollar, the S&P 500, gold and the VIX, over thirty and ninety days, computed on daily returns at common dates. A correlation stays null as long as the aligned history is insufficient.

GET/v1/macro/net-liquiditydata_type · macro_net_liquidity
GET/v1/macro/net-liquidity/historydata_type · macro_net_liquidity_history

Net liquidity: the Fed balance sheet, minus the Treasury general account, minus the overnight reverse repos. The response carries the formula and its components, and the unit is explicit, since the three source series are not in the same one.

GET/v1/macro/momentumdata_type · macro_momentum

A score from −100 to +100, built on the dynamics of M2, the Fed balance sheet and the dollar, over thirty and ninety days. A rising money supply and a falling dollar pull the score up.

GET/v1/macro/riskdata_type · macro_risk

A score from 0 to 100 on five signals: low VIX, dollar retreating, positive yield-curve slope, S&P above its fifty-day average, gold retreating. A signal with no data is excluded from the computation rather than counted as unfavourable.

#Intraday macro

GET/v1/macro/intraday/seriesdata_type · macro_intraday_series
GET/v1/macro/intraday/historydata_type · macro_intraday_history

Ten macro instruments in OHLC candles, to compare crypto by the hour rather than by the day. Five are served on six timeframes: EUR/USD, USD/JPY, WTI crude oil, the dollar index and tokenised gold. Five are served daily only: the 10 year and 30 year rates, the VIX, the S&P and the Nasdaq.

ParameterTypeDefaultDescription
seriesstringrequiredThe identifier of the instrument, as the catalogue returns it.
timeframestringrequired1m, 5m, 15m, 1h, 4h, 1d. The 30m timeframe does not exist in this family.
limitinteger100Number of candles.
curl
curl -H "X-API-KEY: $BYTNODE_KEY" \
  "https://api.bytnode.com/v1/macro/intraday/history?series=EURUSD&timeframe=1h&limit=200"

Asking for a timeframe a series does not serve returns 400 with the list of those it does serve, rather than an empty list, which would suggest a hole in the data.