CLI

Trade prediction markets, equities, options, and crypto. Discover opportunities and manage funds from the command line.

The Horizon CLI gives you full access to the trading engine, market discovery, wallet analytics, and fund management from your terminal. Every command supports --json for pipeable output.

Installation

pip

pip install horizon-sdk

After installation, the horizon command is available on your PATH:

horizon --help

Or run without installing using uvx or bunx:

uvx horizon-sdk top-markets --json | jq '.[0]'
bunx horizon-sdk top-markets --json | jq '.[0]'

Quick Start

# Search for markets
horizon discover "bitcoin"

# See the hottest markets
horizon top-markets --limit 5

# Size a position with Kelly
horizon kelly --prob 0.65 --price 0.50 --bankroll 1000

# Check a wallet's P&L
horizon wallet value 0x1234...abcd

# Run a strategy
horizon run my_strategy.py --mode paper --dashboard

Configuration

The CLI reads configuration from environment variables:

export HORIZON_API_KEY="your-key"
export HORIZON_EXCHANGE="paper"          # paper, polymarket, kalshi
export HORIZON_DB="./horizon.db"         # persistence database path

# For Polymarket live trading
export POLYMARKET_API_KEY="..."
export POLYMARKET_API_SECRET="..."
export POLYMARKET_API_PASSPHRASE="..."
export POLYMARKET_PRIVATE_KEY="..."

# For Kalshi live trading
export KALSHI_API_KEY="..."

Global Options

Flag	Description
--json	Output as JSON (pipeable to jq, scripts)
--version	Show version
--help	Show help

# Human-readable output
horizon discover "election"

# JSON output for scripting
horizon discover "election" --json | jq '.[].slug'

Commands

Discovery

discover - Search markets

horizon discover [QUERY] [OPTIONS]

Option	Default	Description
--exchange	polymarket	Exchange to search
--limit	10	Number of results
--type	all	all, binary, or multi
--category	-	Category filter (crypto, politics)

horizon discover "election" --limit 5
horizon discover "bitcoin" --exchange kalshi
horizon discover --type binary --category crypto --json

events - Multi-outcome events

horizon events [QUERY] [OPTIONS]

Option	Default	Description
--limit	10	Number of events

horizon events "super bowl" --limit 5

top-markets - Highest volume

horizon top-markets [OPTIONS]

Option	Default	Description
--exchange	polymarket	Exchange
--limit	10	Number of markets
--category	-	Category filter

horizon top-markets --limit 20
horizon top-markets --exchange kalshi --json

market - Market detail

horizon market SLUG [OPTIONS]

Option	Default	Description
--exchange	polymarket	Exchange

horizon market "will-trump-win-2024"
horizon market "KXBTC-25MAR14" --exchange kalshi --json

Trading

submit - Place an order

horizon submit [OPTIONS]

Option	Required	Default	Description
--market-id	Yes	-	Market identifier
--side	Yes	-	buy or sell
--price	Yes	-	Limit price (0-1)
--size	Yes	-	Order size
--market-side	No	yes	yes or no

horizon submit --market-id will-btc-hit-100k --side buy --price 0.55 --size 10
horizon submit --market-id will-btc-hit-100k --side sell --market-side no --price 0.45 --size 5

cancel / cancel-all - Cancel orders

horizon cancel ORDER_ID
horizon cancel-all

positions / orders / fills - View state

horizon positions
horizon orders --market-id will-btc-hit-100k
horizon fills --limit 50

kill-switch - Emergency stop

horizon kill-switch on --reason "volatility spike"
horizon kill-switch off

status - Engine overview

horizon status
horizon status --json

Shows PnL, open orders, active positions, kill switch state, and uptime.

Analytics

kelly - Position sizing

horizon kelly [OPTIONS]

Option	Required	Default	Description
--prob	Yes	-	True probability (0-1)
--price	Yes	-	Market price (0-1)
--bankroll	No	1000	Capital in USD
--fraction	No	0.25	Kelly fraction
--max-size	No	100	Max position

horizon kelly --prob 0.65 --price 0.50 --bankroll 5000
horizon kelly --prob 0.8 --price 0.60 --fraction 0.5 --json

parity - Arbitrage check

horizon parity MARKET_ID [--feed FEED_NAME]

Checks if YES + NO prices sum to ~1.0.

horizon parity "will-btc-hit-100k"

simulate - Monte Carlo

horizon simulate [OPTIONS]

Option	Default	Description
--scenarios	10000	Number of paths
--seed	-	Random seed

horizon simulate --scenarios 50000 --json

Wallet Analytics

All wallet commands are under the wallet subgroup:

horizon wallet COMMAND [ARGS]

wallet trades - Trade history

horizon wallet trades ADDRESS [--limit N] [--condition-id ID]

horizon wallet trades 0x1234...abcd --limit 20
horizon wallet trades 0x1234...abcd --json | jq '[.[] | .usdc_size] | add'

wallet positions - Open positions

horizon wallet positions ADDRESS

wallet value - Portfolio value

horizon wallet value ADDRESS

wallet profile - Public profile

horizon wallet profile ADDRESS

wallet score - Performance score

horizon wallet score ADDRESS [--limit N]

wallet top-holders - Largest holders

horizon wallet top-holders CONDITION_ID [--limit N]

wallet flow - Buy/sell flow

horizon wallet flow CONDITION_ID [--window HOURS] [--min-size USD]

wallet market-trades - Market trades

horizon wallet market-trades CONDITION_ID [--limit N]

Feed Management

All feed commands are under the feed subgroup:

horizon feed COMMAND [ARGS]

feed list - Active feeds

horizon feed list
horizon feed list --json

feed snapshot - Latest data

horizon feed snapshot FEED_NAME

feed health - Staleness check

horizon feed health [--threshold SECONDS]

feed metrics - Connection stats

horizon feed metrics FEED_NAME

feed start - Start a feed

horizon feed start NAME TYPE [OPTIONS]

Option	Description
--symbol	Symbol for Binance feeds
--url	URL for REST feeds
--config	JSON config string
--interval	Poll interval (seconds)

horizon feed start btc-price binance_ws --symbol btcusdt
horizon feed start nba-scores espn --config '{"sport":"basketball","league":"nba"}'

Fund Management

All fund commands are under the fund subgroup:

horizon fund COMMAND [ARGS]

fund status / report

horizon fund status
horizon fund report --json

fund deploy / stop / pause / resume

horizon fund deploy --name my-mm --markets will-btc-hit-100k --mode paper
horizon fund stop my-mm
horizon fund pause my-mm
horizon fund resume my-mm

fund list / scale

horizon fund list
horizon fund scale my-mm --capital 10000

fund nav / risk / pnl / stress-test

horizon fund nav --limit 30
horizon fund risk
horizon fund pnl
horizon fund stress-test

fund explain / regime / alerts

horizon fund explain
horizon fund regime
horizon fund alerts --limit 10

Account

setup - Create account

horizon setup [e-mail] --name "My Bot"

login - Login

horizon login [e-mail]

key-status - Check credentials

horizon key-status

Database Queries

For offline analysis of persisted strategy data, use the db subgroup:

horizon db COMMAND [OPTIONS]

db fills - Historical fills

horizon db fills [--path DB] [--limit N] [--market ID]

horizon db fills --path ./my_strategy.db --limit 20
horizon db fills --market will-btc-hit-100k

db positions - Position snapshots

horizon db positions [--path DB]

db orders - Order history

horizon db orders [--path DB] [--limit N] [--open-only/--all]

Scripting with —json

Every command supports --json for structured output. Pipe to jq for powerful scripting:

# Get the slug of the top market
horizon top-markets --limit 1 --json | jq -r '.[0].slug'

# Sum a wallet's total PnL
horizon wallet positions 0x1234...abcd --json | jq '[.[].pnl] | add'

# Find markets with edge > 5%
horizon discover "crypto" --json | jq '[.[] | select(.yes_price < 0.45)]'

# Kelly size across multiple scenarios
for prob in 0.55 0.60 0.65 0.70; do
  echo "prob=$prob: $(horizon kelly --prob $prob --price 0.50 --json | jq .optimal_size)"
done

Architecture

The CLI shares the same tool layer as the MCP servers. All three interfaces delegate to horizon.tools, which wraps the Rust engine via PyO3:

horizon.tools (shared business logic)
    |
    +---> horizon.cli        (Click CLI, for humans)
    +---> horizon.mcp_server (MCP server, for AI agents)
    +---> horizon.mcp_fund   (MCP fund server, for AI agents)

This means the CLI has feature parity with the MCP interface. Same functions, same data, different transport.