Auth
Manage authentication credentials.
# Authenticate with your API key
motion auth login <key>
# Remove stored credentials
motion auth logout
# Show current auth status and usage
motion auth status
# Open developer portal to get an API key
motion auth signup
Entity
Search, inspect, and graph entities. Unified namespace for all entity operations.
# Search entities by name
motion entity search "Trump"
# Filter by category or type
motion entity search "Bitcoin" --type asset
motion entity search "Mahomes" --category sports
# Get detailed entity profile
motion entity get donald-trump
# Include market exposures in output
motion entity get nba-lal --markets
# Entity relationship graph
motion entity graph donald-trump
# Control traversal depth
motion entity graph donald-trump --depth 2
# JSON output for piping
motion entity graph nba-lal --json | jq '.nodes | length'
The old motion entities search and motion graph commands still work as aliases for backwards compatibility.
Markets
Browse and search prediction markets.
# Top trending and high-volume markets
motion markets trending
# Search across venues
motion markets search "election" --venue polymarket
# Filter by category and sort
motion markets filter --category crypto --sort volume --limit 10
Alerts
Monitor real-time alerts.
# List recent alerts
motion alerts list
# Filter by alert type
motion alerts list --type injury
# Live alert feed with polling
motion alerts watch --type arbitrage,injury --interval 15
Arbitrage
Scan for cross-venue mispricings.
# Scan for arbitrage opportunities
motion arb scan
# Set minimum spread threshold
motion arb scan --min-spread 3 --actionable
# Filter by category
motion arb scan --category politics --min-spread 5
# Live arb streaming (polls every 10s)
motion arb watch
# With filters
motion arb watch --min-spread 3 --category politics --interval 5
# Pipe to jq for scripting
motion arb watch --json | jq '.mispricings[] | select(.spread > 0.05)'
motion arb watch is the most powerful CLI feature for power users. It continuously monitors cross-venue spreads and highlights new opportunities as they appear.
News
Market-relevant news feed.
# Top trending news
motion news trending
# News for a specific entity
motion news entity "Bitcoin"
Trading (Polymarket)
Polymarket trading via server-side signing. No local wallet needed.
# Check trading session status
motion trade status
# Initialize trading session (first time)
motion trade init
# Place a buy order by market slug (interactive selection)
motion trade buy "trump president" --size 10 --price 0.55
# Place a buy order by raw tokenId
motion trade buy 0x1234...abcd --size 10 --price 0.55
# Place a sell order
motion trade sell "bitcoin 100k" --size 10 --price 0.65
# Market order (no price required)
motion trade buy "fed rate cut" --size 50 --type market
# Cancel an order
motion trade cancel <orderId>
# View orderbook
motion trade orderbook <tokenId>
# List open positions with PnL
motion positions
# List open orders
motion orders
Trade commands now accept human-readable market slugs. If the input is not a raw token ID, the CLI searches for matching markets and lets you pick interactively.
trade init creates a Gnosis Safe wallet and sets up Polymarket CLOB credentials.
Trading (Hyperliquid)
Trade perpetuals on Hyperliquid.
# Open a long position
motion hl buy BTC --size 1000 --leverage 5
# Open a short position
motion hl sell ETH --size 500 --leverage 3
# Close a position
motion hl close <orderId>
# List current positions with unrealized PnL
motion hl positions
# List available perpetual markets
motion hl markets
# Skip confirmation prompt
motion hl buy SOL --size 200 --leverage 10 -y
# JSON output for scripting
motion hl positions --json | jq '.[] | select(.unrealizedPnl > 0)'
All HL trading commands include confirmation prompts showing margin, leverage, and notional amount. Use -y to skip confirmation for scripted workflows.
Webhooks
Manage webhook endpoints for real-time event delivery.
# List configured webhooks
motion webhook list
# Create a webhook endpoint
motion webhook create https://api.example.com/hooks --events alert.injury,alert.arbitrage
# Delete a webhook
motion webhook delete <webhook-id>
# View recent deliveries
motion webhook deliveries <webhook-id>
Dashboard
Launch the interactive TUI dashboard.
The dashboard provides a live terminal UI with:
- Search (1): Entity search with inline results
- Signals (2): Real-time alert feed
- Markets (3): Top prediction markets by volume
- Arb (4): Cross-venue mispricing scanner
- Intel (5): ISQ scores and sentiment
- Watchlist (6): Personal watchlist
- Chat (7): Market chat rooms
- Profile (8): User profile and stats
- News (9): Breaking news feed
- Discover (0): Market discovery
- Trading (t): Polymarket positions and orders
Press the number key to swap the bottom panel. Press e to expand any panel full-screen. Press ? to show the full keyboard shortcut help overlay.
Update
Check for and install CLI updates.
# Update to the latest version
motion update
Global Options
All commands support these flags:
| Flag | Description |
|---|
--json | Output raw JSON instead of formatted tables |
--help | Show usage details for any command |
-y, --yes | Skip confirmation prompts (trading commands) |
