npm install -g @solpredict/cliVerify
solpredict --versionTerminal-first CLI
Run market, order, funding, margin, and resolution workflows from a shell with structured output for automation.
Terminal toolkit
SolPredict CLI
Trade, inspect, and automate SolPredict from your terminal.
Install the command line interface, connect the Claude plugin, or paste a purpose-built instruction prompt into any AI assistant.
Install
Install the CLI
Use your preferred JavaScript package manager, then verify the binary.
Current CLI package: v0.3.0What it is
Built for terminal and agent workflows
The CLI exposes the same market, trading, funding, margin, and resolution flows used by the web app.
Claude and MCP plugin
Connect Claude Code or any MCP-capable client so an assistant can inspect markets and request confirmation before signing transactions.
Commands
Command catalog
Every command group the CLI exposes today.
AI / discovery
Bootstrap assistants and inspect the CLI.
| Command | Summary | Example |
|---|---|---|
instructions | Print an LLM-ready system prompt. | solpredict instructions |
banner | Print the SolPredict ASCII brand. | solpredict banner |
info | Show the command catalog. | solpredict info |
Get started
Bootstrap a fresh wallet for cash and margin trading.
| Command | Summary | Example |
|---|---|---|
setup status | What's done and what's pending for cash and margin. | solpredict setup status |
setup cash | Deposit cash collateral and enable trading. | solpredict setup cash --amount 10.0 |
setup margin | Initialize the margin account and deposit margin collateral. | solpredict setup margin --amount 25.0 |
Account
Inspect the wallet and move collateral in and out of the protocol.
| Command | Summary | Example |
|---|---|---|
wallet show | Show address, network, and SOL balance. | solpredict wallet show |
wallet airdrop | Request a devnet or testnet SOL airdrop. | solpredict wallet airdrop --sol 1 |
balance | Wallet SOL plus protocol collateral balance. | solpredict balance |
funding deposit | Move collateral into the protocol. | solpredict funding deposit --amount 5.0 |
funding withdraw | Move collateral out of the protocol. | solpredict funding withdraw --amount 5.0 |
funding show | Rich-text view of available, reserved, and locked balances. | solpredict funding show |
Markets
Browse markets, fetch order books, and quote hypothetical trades.
| Command | Summary | Example |
|---|---|---|
markets list | Browse markets. | solpredict markets list --limit 10 |
markets show | Inspect one market in detail. | solpredict markets show 42 |
markets quote | Estimate cost or proceeds for a hypothetical order. | solpredict markets quote 42 --side buy --outcome yes --size 100 --price 5500 |
markets orderbook | Aggregate bids and asks for a market. | solpredict markets orderbook 42 --depth 10 |
markets trades | Recent fills from the off-chain API. | solpredict markets trades 42 --limit 20 |
markets create | Activate a certified market from a JSON params file. | solpredict markets create --params-file ./market.json |
Trading
Place, match, and cancel orders against a market's order book.
| Command | Summary | Example |
|---|---|---|
trade buy | Place a buy order (limit, market, IOC, or FOK; cash or margin). | solpredict trade buy 42 --outcome yes --size 100 --price 5500 |
trade sell | Place a sell order. | solpredict trade sell 42 --outcome yes --size 100 --price 5500 |
trade cancel | Cancel an open order. | solpredict trade cancel 42 7 |
trade match | Match crossable orders on a market's book. | solpredict trade match 42 --yes-order 7 --no-order 8 |
orders list | List orders on a market (defaults to yours). | solpredict orders list --market 42 |
orders show | Show one order by ID. | solpredict orders show 42 7 |
orders cleanup | Clean up an expired order. | solpredict orders cleanup 42 7 |
orders close | Close a settled or cancelled order. | solpredict orders close 42 7 |
Positions and PnL
Inspect open positions and the global leaderboard.
| Command | Summary | Example |
|---|---|---|
positions list | Wallet positions across markets. | solpredict positions list |
positions show | Position in one market. | solpredict positions show 42 |
positions close | Close a fully-settled position. | solpredict positions close 42 |
leaderboard top | Top traders by PnL, ROI, volume, or win rate. | solpredict leaderboard top --sort pnl --limit 20 |
Liquidity
Provide, remove, and claim fees from market liquidity positions.
| Command | Summary | Example |
|---|---|---|
liquidity provide | Provide cash liquidity to a market. | solpredict liquidity provide 42 --amount 10.0 |
liquidity remove | Remove LP shares. | solpredict liquidity remove 42 --shares 5.0 |
liquidity claim-fees | Claim accumulated LP fees. | solpredict liquidity claim-fees 42 |
liquidity close | Close a fully-withdrawn LP position. | solpredict liquidity close 42 |
liquidity show | Inspect your LP position. | solpredict liquidity show 42 |
Margin
Manage the margin account and margin-backed trading or LPing.
| Command | Summary | Example |
|---|---|---|
margin init | Initialize a margin account. | solpredict margin init |
margin status | Inspect the margin account. | solpredict margin status |
margin deposit | Deposit margin collateral. | solpredict margin deposit --amount 10.0 |
margin withdraw | Withdraw margin collateral. | solpredict margin withdraw --amount 5.0 |
margin provide-liquidity | Provide margin LP. | solpredict margin provide-liquidity --amount 10.0 |
margin remove-liquidity | Remove margin LP. | solpredict margin remove-liquidity --shares 5.0 |
margin close-position | Close a margin position. | solpredict margin close-position 42 --outcome yes |
margin close-order | Place a resting order to reduce an open margin position. | solpredict margin close-order 42 --outcome yes --price 5500 --size 1 |
margin cancel-close-order | Cancel a resting margin close order. | solpredict margin cancel-close-order 42 7 --outcome yes |
margin close-liquidity | Close a margin LP position. | solpredict margin close-liquidity |
margin close-account | Close the margin account itself. | solpredict margin close-account |
Resolution
Inspect, challenge, and settle market resolutions.
| Command | Summary | Example |
|---|---|---|
resolution show | Inspect resolution state. | solpredict resolution show 42 |
resolution challenge | Open a resolution challenge. | solpredict resolution challenge 42 --outcome no --evidence-url https://... |
resolution claim-bond | Claim an overturned challenge bond. | solpredict resolution claim-bond 42 --challenge-index 0 |
resolution settle-batch | Settle a chunk of users; loop with --limit. | solpredict resolution settle-batch 42 --owner <pubkey> --limit 10 |
resolution claim-creator | Claim creator fees. | solpredict resolution claim-creator 42 |
Protocol
Read-only protocol state: fees, authorities, and pause status.
| Command | Summary | Example |
|---|---|---|
protocol show | Fees, authorities, and pause state (read-only). | solpredict protocol show |
AI setup
Use with an AI agent
Give an assistant a safe, structured contract for operating the CLI.
Install the packaged plugin when your client supports Claude Code plugins. The plugin exposes SolPredict slash commands and MCP tools while signatures stay local.
Marketplace command (run once)
claude plugin marketplace add https://solpredict.io/cli/marketplace.jsonPlugin install command
claude plugin install solpredictAfter installing, ask Claude to use the SolPredict skill before trading or inspecting markets.