Programmatic Data Access

Endpoint

Authentication

Authorization: Bearer il_your_api_key_here

Response

{
  "download_url": "https://xxxxxxxxx.blob.vercel-storage.com/datasets/full/BTC_5m_depth10_derived.csv.gz?token=...",
  "key": "datasets/full/BTC_5m_depth10_derived.csv.gz",
  "expires_in": "5 minutes"
}

Example — curl

# Fetch a signed download URL for BTC orderbook data
curl -s \
  -H "Authorization: Bearer il_your_api_key_here" \
  "https://imbalancelabs.com/api/deliver?key=datasets/full/BTC_5m_depth10_derived.csv.gz"

# Download the file using the returned URL
curl -o BTC_5m_depth10_derived.csv.gz "$(
  curl -s \
    -H "Authorization: Bearer il_your_api_key_here" \
    "https://imbalancelabs.com/api/deliver?key=datasets/full/BTC_5m_depth10_derived.csv.gz" \
    | jq -r '.download_url'
)"

Example — Python

import requests, gzip, io
import pandas as pd

API_KEY = "il_your_api_key_here"
BASE    = "https://imbalancelabs.com"
TICKER  = "BTC"

# 1. Get signed download URL
resp = requests.get(
    f"{BASE}/api/deliver",
    params={"key": f"datasets/full/{TICKER}_5m_depth10_derived.csv.gz"},
    headers={"Authorization": f"Bearer {API_KEY}"},
)
resp.raise_for_status()
download_url = resp.json()["download_url"]

# 2. Download & load into pandas
data = requests.get(download_url).content
df = pd.read_csv(io.BytesIO(data), compression="gzip")

print(f"Loaded {len(df):,} rows × {len(df.columns)} columns")
print(df.head())