> For the complete documentation index, see [llms.txt](/llms.txt).

# Trade prediction markets

Search markets, fund your predict deposit wallet, and place orders on Polymarket through `mm predict`.

## Ask your agent[​](#ask-your-agent "Direct link to Ask your agent")

```
You (to your agent): "Bet 10 USDT on YES for BTC 5-min price up"

```

```
You (to your agent): "Show my open prediction market positions"

```

Your agent runs one-time setup if needed, shows current odds, confirms your bet, then places the order.

## Prerequisites[​](#prerequisites "Direct link to Prerequisites")

- [Quickstart](/agent-wallet/quickstart/) completed
- Polygon USDC.e in your owner EOA for `mm predict deposit` (converts to pUSD in the predict deposit wallet)

## First-time setup[​](#first-time-setup "Direct link to First-time setup")

1. Run one-time setup:  
```  
mm predict setup --wait  
```  
If the command returns a job ID instead of completing immediately, track it with `mm predict watch <JOB_ID> --wait`.
2. Fund the predict deposit wallet:  
```  
mm predict deposit --amount <AMOUNT> --wait  
```
3. Confirm balance:  
```  
mm predict balance --sync  
```

## Search and place an order[​](#search-and-place-an-order "Direct link to Search and place an order")

1. Search markets:  
```  
mm predict markets search "<QUERY>" --limit 5  
```
2. Preview a quote:  
```  
mm predict quote --token-id <TOKEN_ID> --side buy --size <SIZE> [--limit-price <PRICE>]  
```
3. Inspect a market to get outcome token IDs:  
```  
mm predict markets get <MARKET_SLUG_OR_ID>  
```
4. Place the order:  
```  
mm predict place --token-id <TOKEN_ID> --side buy --size <SIZE> --price <PRICE> [--order-type GTC|GTD|FOK|FAK]  
```  
`--limit-price` applies to `mm predict quote` only. `mm predict place` requires `--price`(worst fill price per share, between 0 and 1).
5. View open orders and positions:  
```  
mm predict orders  
mm predict positions  
```

## Common pitfalls[​](#common-pitfalls "Direct link to Common pitfalls")

One-time setup is required

Polymarket trading routes through a dedicated predict deposit wallet. Run `mm predict setup`followed by `mm predict deposit --amount <N>` before placing your first order. Skipping setup can produce `JsonRpcError: execution reverted` on deposit.

## Related commands[​](#related-commands "Direct link to Related commands")

See [mm predict](/agent-wallet/reference/commands/#mm-predict) in the commands reference.