> 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/positions-and-orders.md).

# Positions & Orders

***

### Overview

Once you've placed trades, you need to track how they're doing. Positions & Orders gives you a real-time view of every outcome share you hold, your current PnL, and any limit orders still waiting to fill.

**What you can do:**

* View all open positions with current value and PnL
* Check positions in a specific market
* See all pending limit orders
* Monitor your USDC.e and POL balances on Polygon

***

### Viewing Positions

Your positions are the outcome shares you currently hold. Each position shows the market, which side you're on (Yes/No), how many shares you hold, your cost basis, current value, and profit or loss.

| Prompt                                     | Interpretation                           |
| ------------------------------------------ | ---------------------------------------- |
| "Show my Polymarket positions"             | All positions with current value and PnL |
| "What positions do I have?"                | Full position overview                   |
| "How are my prediction market bets doing?" | All positions with performance           |
| "Show my position on the BTC $150k market" | Position in a specific market            |
| "Am I up or down on my Polymarket trades?" | Overall PnL snapshot                     |

#### What You'll See

For each position:

| Field             | What It Shows                        |
| ----------------- | ------------------------------------ |
| **Market**        | The event/question you're trading on |
| **Outcome**       | Which side you hold (Yes or No)      |
| **Shares**        | Number of outcome tokens you hold    |
| **Avg Price**     | Your average cost per share          |
| **Current Price** | Where the outcome is trading now     |
| **Current Value** | Shares × current price               |
| **Cost Basis**    | What you originally paid             |
| **PnL**           | Current value minus cost basis       |

#### Understanding Your PnL

Your PnL on prediction markets comes from two sources:

**1. Price movement (before resolution)** You bought 100 Yes shares at $0.40 ($40 total). Price moves to $0.60. Your position is now worth $60. Unrealized PnL: +$20.

**2. Event resolution (final payout)** The event resolves Yes. Each share pays $1. Your 100 shares pay out $100. Realized PnL: +$60 ($100 payout minus $40 cost).

***

### Checking Specific Markets

Filter your positions to a specific market when you want to focus on one trade.

| Prompt                                        | Interpretation                           |
| --------------------------------------------- | ---------------------------------------- |
| "Show my position on the election market"     | Position details for that specific event |
| "How many Yes shares do I hold on BTC $150k?" | Share count and value for one position   |
| "What's my PnL on the NBA Finals market?"     | PnL for a specific position              |
| "Am I holding anything on the Oscar market?"  | Checks if you have a position            |

***

### Viewing Open Orders

Open orders are your pending limit orders that haven't filled yet. They sit on the order book waiting for the price to reach your level.

| Prompt                                       | Interpretation             |
| -------------------------------------------- | -------------------------- |
| "Show my open orders"                        | All pending limit orders   |
| "Do I have any unfilled orders?"             | Checks for pending orders  |
| "Show my open orders on the election market" | Orders for specific tokens |
| "What limit orders do I have?"               | All pending limits         |

#### What You'll See

For each open order:

| Field       | What It Shows                                 |
| ----------- | --------------------------------------------- |
| **Market**  | Which market the order is on                  |
| **Side**    | Buy or Sell                                   |
| **Outcome** | Yes or No                                     |
| **Price**   | Your limit price                              |
| **Size**    | Order amount (USD for buys, shares for sells) |
| **Status**  | Open, partially filled                        |

***

### Managing Orders

| Prompt                                    | Interpretation                       |
| ----------------------------------------- | ------------------------------------ |
| "Cancel my order on the BTC market"       | Cancels a specific pending order     |
| "Cancel all my orders"                    | Cancels every pending order          |
| "Cancel my orders on the election tokens" | Cancels orders for specific outcomes |

{% hint style="info" %}
**Tip**: If a market is moving against your limit price, consider cancelling and re-placing at a more competitive level.
{% endhint %}

***

### Checking Balances

Your Polymarket trading happens on Polygon. Check your available balance to know how much you can trade.

| Prompt                                | Interpretation                     |
| ------------------------------------- | ---------------------------------- |
| "What's my Polymarket balance?"       | USDC.e and POL balances on Polygon |
| "How much can I trade on Polymarket?" | Available USDC.e balance           |
| "Show my Polygon balances"            | Full balance view                  |

| Token      | What It's For                                 |
| ---------- | --------------------------------------------- |
| **USDC.e** | The currency used to buy shares on Polymarket |
| **POL**    | Polygon's native token, used for gas fees     |

***

### Position Lifecycle

Here's how a prediction market position flows from entry to exit:

#### Scenario 1: Sell Before Resolution

```
1. Buy 100 Yes shares at $0.40 ($40 spent)
2. Probability rises to $0.70
3. Sell 100 shares at $0.70 ($70 received)
4. Profit: $30 (75% return)
→ You don't need to wait for the event to resolve
```

#### Scenario 2: Hold to Resolution (Correct)

```
1. Buy 100 Yes shares at $0.40 ($40 spent)
2. Event resolves Yes
3. Each share pays out $1.00 ($100 received)
4. Profit: $60 (150% return)
```

#### Scenario 3: Hold to Resolution (Incorrect)

```
1. Buy 100 Yes shares at $0.40 ($40 spent)
2. Event resolves No
3. Each share is worth $0.00
4. Loss: $40 (100% loss)
```

#### Scenario 4: Partial Exit

```
1. Buy 200 Yes shares at $0.30 ($60 spent)
2. Price moves to $0.55
3. Sell 100 shares at $0.55 ($55 received, nearly covers cost basis)
4. Hold remaining 100 shares risk-free
5. If event resolves Yes → $100 additional payout
```

***

### Common Workflows

#### Morning Check

```
1. "Show my Polymarket positions"     → See all positions and PnL
2. "Show my open orders"              → Check if any limits filled overnight
3. "What's my balance?"               → Available capital for new trades
```

#### Position Review

```
1. "Show my position on BTC $150k"    → Current value and PnL
2. "What's the current price on Yes?" → Has probability moved?
3. "Price history on this market"     → Trend direction
4. Decide: hold, add, reduce, or exit
```

#### Taking Profits

```
1. "Show my positions"                → Identify winners
2. "What's the price on my Yes shares?" → Current value
3. "Sell 50 shares at $0.80"          → Limit sell for profit
   Or: "Sell all my Yes shares"        → Market sell to exit entirely
```

***

### Pro Tips

1. **Check positions regularly** - Prediction markets can move fast on news events
2. **Don't forget about open orders** - Unfilled limit orders still commit capital in some cases
3. **Partial exits reduce risk** - Sell enough shares to cover your cost basis and let the rest ride for free
4. **Track your average price** - If you bought at multiple levels, your average matters more than any single entry
5. **Consider selling before resolution** - A bird in the hand: locking in a 50% gain now is sometimes better than waiting for a potential 150%
6. **Keep enough USDC.e for new opportunities** - Don't go all-in on one market, new events appear constantly

***


---

# 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/positions-and-orders.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.