Skip to main content

Overview

The Poly Storage CLI is maintained in its own repository: It is independent from the SDK package and can be released separately.

Install

Use one of these install methods:
python3 -m pip install --upgrade poly-storage-cli

Authentication

Use either --api-key or the ENTITY_API_KEY environment variable:
export ENTITY_API_KEY="YOUR_API_KEY"

Coverage notes

  • Orderbook data exists for a subset of markets from 2025-09-01 on Polymarket and 2026-02-17 for Kalshi, but coverage is not continuous.
  • Continuous Polymarket crypto-related market coverage begins on 2026-02-04. Continuous Kalshi crypto-related market coverage begins on 2026-02-25.
  • Continuous coverage for all markets begins 2026-04-02 for Polymarket and 2026-03-31 for Kalshi.
  • Use the Polymarket and Kalshi date-range endpoints to confirm per-market availability.

Commands

Health check

poly-storage health

Polymarket raw market data

poly-storage polymarket market-data \
  --condition-id 0x8213d395e079614d6c4d7f4cbb9be9337ab51648a21cc2a334ae8f1966d164b4 \
  --date 2026-02-13 \
  --offset 0 \
  --limit 500

Polymarket orderbook summary

poly-storage polymarket orderbook-summary \
  --condition-id 0x8213d395e079614d6c4d7f4cbb9be9337ab51648a21cc2a334ae8f1966d164b4 \
  --date 2026-02-13 \
  --resolution 60

Kalshi raw market data

poly-storage kalshi market-data \
  --ticker KXBTC-26FEB2606-B60125 \
  --date 2026-02-26 \
  --offset 0 \
  --limit 500

Kalshi orderbook summary

poly-storage kalshi orderbook-summary \
  --ticker KXBTC-26FEB2606-B60125 \
  --date 2026-02-26 \
  --resolution 60

API key commands

poly-storage api-keys create --name my-key --user-id YOUR_USER_ID
poly-storage api-keys list --user-id YOUR_USER_ID
poly-storage api-keys delete --key-id YOUR_KEY_ID --user-id YOUR_USER_ID
All commands return JSON to stdout.