Docs

# 1. your key, from the page you saw right after paying
export OT_KEY="ck_a1b2c3d4e5f6.xxxxxxxxxxxxxxxxxxxxxxxx"

# 2. what can I get?
curl -s -H "Authorization: Bearer $OT_KEY" \
  https://outcometick.com/v1/meta

# 3. find a file — with no date filter you get the newest day your key reaches
curl -s -H "Authorization: Bearer $OT_KEY" \
  "https://outcometick.com/v1/files?asset=btc&dataset=prices"

# 4. download it — every file in that listing carries its own url
URL=$(curl -s -H "Authorization: Bearer $OT_KEY" \
  "https://outcometick.com/v1/files?asset=btc&dataset=prices" \
  | jq -er '.files[0].url')

curl -L -H "Authorization: Bearer $OT_KEY" "$URL" -o btc-prices.csv.gz

import pandas as pd, requests

KEY  = "ck_a1b2c3d4e5f6.xxxxxxxxxxxxxxxxxxxxxxxx"
auth = {"Authorization": f"Bearer {KEY}"}

r = requests.get("https://outcometick.com/v1/files", headers=auth,
                 params={"asset": "btc", "dataset": "prices"})

# the download endpoint also takes ?api_key=, for clients that cannot set a header.
# The URL no longer ends in .gz, so name the compression; full_accuracy_value is
# a 1e18 fixed-point integer wider than int64, so keep it as text.
df = pd.read_csv(r.json()["files"][0]["url"] + "?api_key=" + KEY,
                 compression="gzip", dtype={"full_accuracy_value": str})
print(df.head())

import duckdb, pandas as pd, polars as pl, requests

KEY  = "ck_a1b2c3d4e5f6.xxxxxxxxxxxxxxxxxxxxxxxx"
auth = {"Authorization": f"Bearer {KEY}"}

def newest(dataset):
    r = requests.get("https://outcometick.com/v1/files", headers=auth,
                     params={"venue": "polymarket", "asset": "btc", "dataset": dataset})
    return r.json()["files"][0]["url"] + "?api_key=" + KEY

# CSV — settlement prices, here; klines read the same way
prices = newest("prices")
pl.read_csv(prices)
# types= only for prices / twap30s / twap60s: it errors on a file without the column
duckdb.sql(f"SELECT * FROM read_csv('{prices}', types={{'full_accuracy_value': 'VARCHAR'}})").df()

# JSONL — markets, book, trades: ids and prices are strings, keep them that way
markets = newest("markets")
pd.read_json(markets, lines=True, compression="gzip", dtype=False)
pl.read_ndjson(markets)
duckdb.sql(f"SELECT * FROM read_json('{markets}')").df()

import duckdb, polars as pl, requests

KEY  = "ck_a1b2c3d4e5f6.xxxxxxxxxxxxxxxxxxxxxxxx"
auth = {"Authorization": f"Bearer {KEY}"}

# format=parquet lists the Parquet copy of each file: the same rows, already typed
r = requests.get("https://outcometick.com/v1/files", headers=auth, params={
    "venue": "polymarket", "asset": "btc", "dataset": "book", "format": "parquet"})
url = r.json()["files"][0]["url"] + "?api_key=" + KEY

pl.read_parquet(url)
duckdb.sql(f"SELECT * FROM read_parquet('{url}')").df()

# Claude Code — every key is optional; public tools work without any
claude mcp add outcometick \
  -e OT_KEY="ck_a1b2c3d4e5f6.xxxxxxxxxxxxxxxxxxxxxxxx" \
  -e OT_SMART_KEY="ck_f6e5d4c3b2a1.xxxxxxxxxxxxxxxxxxxxxxxx" \
  -e OT_BACKTEST_KEY="bt_a1b2c3d4e5f6.xxxxxxxxxxxxxxxxxxxxxxxx" \
  -- npx -y -p outcometick ot mcp

{
  "mcpServers": {
    "outcometick": {
      "command": "npx",
      "args": ["-y", "-p", "outcometick", "ot", "mcp"],
      "env": { "OT_KEY": "ck_a1b2c3d4e5f6.xxxxxxxxxxxxxxxxxxxxxxxx" }
    }
  }
}

# Remote: nothing to install. The key goes in a header…
claude mcp add --transport http outcometick https://outcometick.com/v1/mcp \
  --header "Authorization: Bearer ck_a1b2c3d4e5f6.xxxxxxxxxxxxxxxxxxxxxxxx"

# …or leave --header out and sign in with your keys in the browser (OAuth).
# Public tools only, no key: https://outcometick.com/v1/mcp/public

# the newest day your key reaches
DAY=$(curl -s -H "Authorization: Bearer $OT_KEY" \
  https://outcometick.com/v1/meta | jq -r .lastDay)

# every BTC 5-minute order book for that day
curl -s -H "Authorization: Bearer $OT_KEY" \
  "https://outcometick.com/v1/files?date=$DAY&asset=btc&interval=5m&dataset=book"

DAY=$(curl -s -H "Authorization: Bearer $OT_KEY" \
  https://outcometick.com/v1/meta | jq -r .lastDay)

# everything a 5-minute market needs: the 5m slices AND the settlement streams
curl -s -H "Authorization: Bearer $OT_KEY" \
  "https://outcometick.com/v1/files?date=$DAY&asset=btc&interval=5m,none"

#!/usr/bin/env bash
# a month of BTC settlement prices, downloaded and checksum-verified
set -euo pipefail
export OT_KEY="ck_a1b2c3d4e5f6.xxxxxxxxxxxxxxxxxxxxxxxx"

# 30 days back from the newest day you can reach, clamped to the oldest —
# one call covers at most 92 days, and your window may be shorter than either
read -r FROM TO < <(curl -s -H "Authorization: Bearer $OT_KEY" \
  https://outcometick.com/v1/meta \
  | jq -r '((.lastDay | strptime("%Y-%m-%d") | mktime) - 29*86400
            | strftime("%Y-%m-%d")) as $back
           | "\(if $back < .firstDay then .firstDay else $back end) \(.lastDay)"')

curl -s -H "Authorization: Bearer $OT_KEY" \
  "https://outcometick.com/v1/files?asset=btc&dataset=prices&from=$FROM&to=$TO" \
| jq -r '.files[] | "\(.url) \(.name) \(.sha256)"' \
| while read -r url name sha; do
    curl -sL -H "Authorization: Bearer $OT_KEY" "$url" -o "$name"
    echo "$sha  $name" | sha256sum -c -
  done

import pandas as pd, requests
from datetime import date, timedelta

KEY  = "ck_a1b2c3d4e5f6.xxxxxxxxxxxxxxxxxxxxxxxx"
BASE = "https://outcometick.com"
auth = {"Authorization": f"Bearer {KEY}"}

meta  = requests.get(f"{BASE}/v1/meta", headers=auth).json()
last  = date.fromisoformat(meta["lastDay"])
first = max(date.fromisoformat(meta["firstDay"]), last - timedelta(days=6))

# every 1-minute kline for BTC over the last week your key reaches
r = requests.get(f"{BASE}/v1/files", headers=auth, params={
    "asset": "btc", "dataset": "klines", "interval": "1m",
    "from": first.isoformat(), "to": last.isoformat(),
})
files = r.json()["files"]

df = pd.concat(
    pd.read_csv(f["url"] + "?api_key=" + KEY, compression="gzip") for f in files
).sort_values("ts_ms")
print(len(df), "rows")