> For the complete documentation index, see [llms.txt](https://docs.boba.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.boba.xyz/agents/boba-agents/core-capabilities/prediction-markets.md).

# Prediction Markets

***

### Overview

Prediction markets let you trade on real-world outcomes. You buy and sell outcome shares that represent probability. Shares are priced from **$0 to $1**. 

{% hint style="info" %}
Boba Agents trades prediction markets on **Polymarket**.
{% endhint %}

***

### What you can do

* Discover and filter markets by category, volume, and keywords
* Analyze markets with price history, order books, and top-holder data
* Buy and sell outcome shares at market or with limit orders
* Track open positions, PnL, and outstanding orders
* Review fills and full trade history
* Research other traders’ profiles and positions

### Polymarket integration

Trade on real-world event outcomes through Polymarket across politics, sports, crypto, and entertainment. Buy and sell shares priced $0 to $1, and collect $1 per share if your prediction is correct.

{% hint style="warning" %}
Prediction markets involve real money. Research the event, check liquidity, and size positions you can afford to lose.
{% endhint %}

***

### Example prompts

```
Search for crypto prediction markets
Show me the BTC $150k market
Buy $20 of Yes shares
Place a limit buy at $0.35
Show my Polymarket positions
Cancel my open orders
Show my Polymarket trade history
```

***

### Core pages

<table data-view="cards"><thead><tr><th>Page</th><th>Description</th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h4>Getting Started</h4></td><td>Basics, key concepts, and first-time approvals.</td><td><a href="/spaces/DdpQIQSF1FubGThe6umC/pages/L1FYuYQxStBNlJkrTAjm">/spaces/DdpQIQSF1FubGThe6umC/pages/L1FYuYQxStBNlJkrTAjm</a></td></tr><tr><td><h4>Discover Markets</h4></td><td>Browse events and find markets worth trading.</td><td><a href="/spaces/DdpQIQSF1FubGThe6umC/pages/2f11d6sEjrxvfiQBNsnt">/spaces/DdpQIQSF1FubGThe6umC/pages/2f11d6sEjrxvfiQBNsnt</a></td></tr><tr><td><h4>Market Analysis</h4></td><td>Order books, price history, token data, and top holders.</td><td><a href="/spaces/DdpQIQSF1FubGThe6umC/pages/ZzVg47B8rnUIcz2WSqA1">/spaces/DdpQIQSF1FubGThe6umC/pages/ZzVg47B8rnUIcz2WSqA1</a></td></tr><tr><td><h4>Place Trades</h4></td><td>Market buys/sells and limit orders for outcome shares.</td><td><a href="/spaces/DdpQIQSF1FubGThe6umC/pages/LHuCuPbDkkOQjlDZf432">/spaces/DdpQIQSF1FubGThe6umC/pages/LHuCuPbDkkOQjlDZf432</a></td></tr><tr><td><h4>Positions &#x26; Orders</h4></td><td>Monitor positions, PnL, balances, and open orders.</td><td><a href="/spaces/DdpQIQSF1FubGThe6umC/pages/YL27jPlBNDHwmxF0E9RM">/spaces/DdpQIQSF1FubGThe6umC/pages/YL27jPlBNDHwmxF0E9RM</a></td></tr><tr><td><h4>Trade History</h4></td><td>Audit fills and review executed trades.</td><td><a href="/spaces/DdpQIQSF1FubGThe6umC/pages/OAPpxVF5kgYJhLPW44r4">/spaces/DdpQIQSF1FubGThe6umC/pages/OAPpxVF5kgYJhLPW44r4</a></td></tr><tr><td><h4>Research Traders</h4></td><td>Look up other traders’ profiles and activity.</td><td><a href="/spaces/DdpQIQSF1FubGThe6umC/pages/cTMBqBU0l6dqD8vRpz4P">/spaces/DdpQIQSF1FubGThe6umC/pages/cTMBqBU0l6dqD8vRpz4P</a></td></tr></tbody></table>

***


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.boba.xyz/agents/boba-agents/core-capabilities/prediction-markets.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.