> For the complete documentation index, see [llms.txt](https://docs.vishwalab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vishwalab.com/vishwa-cli/using-the-cli.md).

# Using the CLI

Everything below happens in plain English. Each action is submitted as an unsigned request through the gateway and cleared by the control layer before it executes. Figures shown are example values from a recorded demo session and will differ from your live account.

## Check your wallet

```
get my wallet
```

You get a live on-chain snapshot - the same balance the control layer reads independently when it checks solvency:

| Field       | Example                    |
| ----------- | -------------------------- |
| Address     | your Solana address        |
| SOL balance | 0.0951 SOL                 |
| Tokens      | USDC: 10.38, JupUSD: 10.26 |

## Browse prediction markets

Vishwa connects to Polymarket:

```
show me the polymarket hot events
```

Then drill into a market by name:

```
2026 FIFA World Cup Winner
```

The agent returns a ranked table of outcomes with live prices and volume, and explains the mechanics: each outcome is a Yes/No market; buying "Yes" at $0.162 pays $1.00 per share if that outcome wins. Prices move as people trade, and eliminated outcomes settle to "No."

## Place a trade

```
buy France 10 yes contracts in this market
```

The agent:

1. **Looks up the live orderbook** for the best available ask.
2. **Handles venue rules.** Polymarket enforces a $5 minimum order; if your request is below it, the agent scales the order to the minimum and tells you why before committing.
3. **Submits the request through the gateway**, where the control layer verifies it against your policy: operation allowed, venue approved, cost within per-trade and daily caps, fill within slippage of the live book.
4. **Signs and submits** - only because the request passed. You get a confirmation with the transaction signature.

If the order had exceeded your per-trade cap or hit an un-approved venue, the control layer would deny it before signing.

## Check your positions

```
show me my positions
```

Per position you see contracts held, average purchase price, cost basis, current mark, open orders, and unrealized P\&L. You can claim the payout if the outcome wins, or sell any time before resolution.

## Close a position

```
sell all contracts in this position
```

The exit is verified the same way as the entry - request through the gateway, cleared by the control layer - then filled at the live bid and confirmed with a transaction signature and a round-trip summary.

## Session recap

```
get my wallet
```

Asking again at the end of a session shows a before/after view: balance changes per asset, fees, and a plain-English recap of the session's net result.