> ## Documentation Index > Fetch the complete documentation index at: https://docs.sesameterminal.com/llms.txt > Use this file to discover all available pages before exploring further. # Portfolio and orders # Portfolio and orders This page shows how to follow what you hold and what waits on the book. **Portfolio** shows your positions, their value and [P\&L](glossary.md#positions-and-money), your combos and your account history. **Orders** shows your open orders, the orders refused in this session and today’s fills. Back to the [guide index](index.md). Terms are explained in the [glossary](glossary.md). ## In short * **Portfolio** shows what you hold. **Orders** shows what waits on the book. * The bottom dock shows the same positions, orders and fills in a short form on the other pages. Each position in the dock has an **Exit** button. * The buttons and keys that place or cancel orders work only while the switch reads **Armed**. Right-click on an order in **Orders** cancels it at once, with no menu. * A greyed value is stale: no updates come from its book now. * Money moves only on polymarket.com. The app never deposits, withdraws or claims. ## The basics ### Check your positions and P\&L 1. Click **Portfolio** in the left rail, or press `g` then `p`. 2. Read the totals at the top of the page. 3. Read one row per position below the totals. Portfolio: totals across the top, then one row per position with its actions on hover The totals at the top: | Figure | Meaning | | - | - | | **Value (liq)** | What your open positions would get if you sold them into the current bids | | **Unrealised P\&L** | Value (liq) minus what you paid for those positions | | **Cash** | Your spendable pUSD | | **Open orders** | How many of your orders wait on the book | | **Cost basis** | What you paid for your open positions. Not shown on a phone | Each position row: | Column | Meaning | | - | - | | **Market / outcome** | The outcome you hold, then its market. Click the name to open the market | | **Game / ends** | For a game: the start time, then the score and clock, then `Final`. For any other market: its end date | | **Size (sh)** | Shares you hold | | **Avg (¢)** | The average price you paid | | **Bid (¢)** | The best bid now | | **Liq val (\$)** | What the position would get if you sold it into the bids now | | **P\&L (\$)** | Unrealised profit or loss, with a `+` or `−` sign | | **Orders** | Your open orders in this outcome. Blank when you have none | | **Actions** | **Exit**, **Join**, **Add** and the cancel X. On desktop they show when you hover the row or move to it with the keys | A small warning triangle before **Liq val (\$)** means that the bids cannot take the whole position. Its tooltip is `The visible bids cannot absorb the whole position; the value covers them only`. Times use one format in the whole app: | Time | Shown as | | - | - | | Less than 24 hours away | `in 12m`, `3h ago`, `45s ago` | | 24 hours or more away | `3 Oct 14:47`, on a 24-hour clock | | A game that starts in the next 10 minutes | A countdown, such as `in 1:41` | Hover a time to see the exact local time. Values change only when the book changes or when your orders fill. If a value is grey, its book does not update now. The score shows `· stale` when the score feed stops. ### Act on a position Hover the row to show its buttons. On a phone, each position is a card with its buttons always shown. | Button | Key | What it does | | - | - | - | | **Exit 21¢** | `E` | Sells the whole position now, down to the price on the button. See [Exit a position](trading.md#exit-a-position) | | **Join 23¢** | `J` | Puts a sell for the whole position on the book at the best ask | | **Add 23¢** | `A` | Buys your stake at the best ask. On a phone the button shows the stake, such as **Add \$50** | | X and a count | `C` | Cancels your open orders in this market, in every outcome. The count is the number of those orders | All four buttons need **Armed**. In **Safe** they are grey, and their tooltip says `Safe`. Other tooltips on a grey button: `No exit price yet`, `No asks`, `Stale`, `Market closed`, `Trading off`. To use the keys on desktop: 1. Click the list of positions. 2. Press `↑` or `↓` to select a row. 3. Press `E`, `J`, `A` or `C`. `↑`, `↓` and `↵` work in **Safe**. The letter keys work only while **Armed**. When a small triangle shows on the **Exit** button, the bids within your exit slippage cannot take the whole position. The tooltip gives the price where the rest of the position stays on the book. ### Open the ladder of a position 1. Click the row, or select it and press `↵`. 2. The row opens. The price ladder is on the left and **Orders in this market** is on the right. 3. Click the row again, or press `↵`, to close it. On a phone, tap the card to open the ladder in a sheet. ### See your open orders 1. Click **Orders** in the left rail, or press `g` then `o`. 2. Make sure that the **Open** tab is selected. The **Open** tab lists every order that waits on the book, under a heading for each market. A line at the top gives the totals, such as `4 open · $1,821.00 resting`. Click the chevron on a market heading to close or open that market. | Column | Meaning | | - | - | | **Market / outcome** | The outcome, under its market heading. Click it to open the market | | **Side** | **Buy** or **Sell** | | **Price (¢)** | Your price. Hover the row to show `−` and `+`, which move the order one tick. See [Move an order](trading.md#move-an-order) | | **Size (sh)** | The full size of the order | | **Filled (sh)** | How much filled, such as `20`, with `20/50 sh` in the tooltip. Blank when nothing filled | | **Status** | Blank while the order is open. Other values are in [Order statuses](order-rules.md#order-statuses) | | **Age** | How long ago you placed the order: `3s`, `2m`, `1h`, `2d`. Only on screens 1920 px wide or more | | **Best (¢)** | The best price on your side now: the best bid for a buy, the best ask for a sell | | **Dist** | Ticks from the best price. `0` is at the best price, `−2` is two ticks behind it. Only on screens 1920 px wide or more | On a phone, each order is a card. Tap the card to see the best price, the distance and the age. ### Cancel an order | To cancel | Do this | | - | - | | One order | Hover the order and click the X. Or right-click the order | | One order, on a phone | Touch and hold the card for half a second | | Every order in one market | Click **Cancel (N)** in the market heading | | Selected orders | Select them, then click **Cancel N** in the bar. See [Work with many orders at once](#work-with-many-orders-at-once) | Right-click and a touch and hold cancel at once. No menu opens. An order in an in-play delay shows the tooltip `In delay window: the cancel is sent when it ends`. ## More options ### Change what Portfolio shows | Control | Choices | | - | - | | Tabs | **Positions** and **Combos**, each with a count, and **Activity** | | Position status | **Open**, **Redeemable**, **Closed** | | **Group** | **Event**, **League**, **Expiry**, **Venue**, **None**. Only on **Open** | | Sort | Click **Game / ends**, **Size (sh)**, **Liq val ($)** or **P&L ($)**. Each click changes the order: largest first, smallest first, then no sort | **Expiry** puts positions in `Today`, `This week`, `Later` and `No end date`. **League** puts positions that are not in a game in `Other`. A group with two or more positions gets a heading. The heading shows the name, the count, the total **Liq val ($)** and **P&L ($)**, and the number of open orders. Hover the heading to show an X that cancels the orders of that group. Click the heading to close or open the group. The app keeps your grouping and sort for your next visit. ### Claim winnings When a market resolves, its positions move to **Redeemable**. Each row shows: | Column | Meaning | | - | - | | **Result** | `Won` or `Lost` | | **Payout** | \$1 for each winning share | | **Claim** | **Claim on polymarket.com** for a winning position | The link opens polymarket.com in a new tab. You claim there. The app does not claim for you. When there is nothing to claim, the tab shows `Nothing to claim`. **Closed** lists the positions that you do not hold now, with their realised P\&L in **Realised**. When there are none, it shows `No closed positions`. ### Look at your history The **Activity** tab has a P\&L chart and the history of the account. * The chart shows **1D**, **1W**, **1M** or **All**. It opens on **1W**. * The history has the columns **Time**, **Market / outcome**, **Type**, **Side**, **Price**, **Size** and **Value**. **Value** is green for money in and red for money out. | Type | Meaning | | - | - | | `Trade` | A fill of one of your orders | | `Redeem` | Winnings claimed on polymarket.com | | `Split`, `Merge`, `Conversion` | Share changes made on polymarket.com | | `Reward` | A reward that Polymarket paid | | `Transfer in`, `Transfer out` | pUSD that you moved on polymarket.com, such as a deposit or a withdrawal | | `Combo`, `Combo redeem` and other `Combo …` types | The same events for a combo | | `Other` | Any other account event | ### Work with many orders at once 1. Open **Orders** and select the **Open** tab. 2. Select the orders. Use one of these: * Click the box at the start of a row. * Move to a row and press `Space`. * Shift-click a second row to select the rows between them. * Press `Ctrl A`, or click the box in the header, to select every order shown. 3. Read the bar that replaces the line of totals, such as `3 selected`. 4. Click one action in the bar. | Button | What it does | | - | - | | **−1 tick**, **+1 tick** | Moves each selected order one tick down or up | | **Join best** | Moves each buy to the best bid and each sell to the best ask | | **Cancel 3** | Cancels the selected orders | | **Clear** | Clears the selection | A toast gives the result, such as `Repriced 2 · 1 delayed · 1 unchanged`. The app does not move an order in an in-play delay or with a cancel on its way. It counts them as `delayed`. An order that is at the best price already, or that cannot move further, counts as `unchanged`. On a phone, tap **Select** to start and **Done** to stop. The bar is at the bottom of the screen, with the short labels **−1**, **+1** and **Join**. Other controls on the **Open** tab: | Control | What it does | | - | - | | **All**, **Buy**, **Sell**, **Delayed** | Show only those orders | | **Group by market** | Show or hide the market headings | ### See refused orders and fills | Tab | What it lists | | - | - | | **Rejected** | The orders refused in this session, with **Time**, **Market / outcome**, **Side**, **Price**, **Size**, **Reason** and **Source**. **Source** is `risk` (the app’s checks), `venue` (Polymarket) or `network`. The list clears when you reload the page. For each reason, see [Reject messages](order-rules.md#reject-messages) | | **Fills today** | Each fill today, with **Time**, **Market / outcome**, **Side**, **Price (¢)**, **Size (sh)**, **Fee (\$)**, **Role** and **Status** | In **Fills today**, **Role** is `Maker` if your order waited on the book, or `Taker` if it filled when it arrived. **Status** shows how the fill settled on chain: | Status | Meaning | | - | - | | `Matched` | Polymarket matched the order | | `Mined` | The trade is on chain | | `Confirmed` | The trade is final | | `Retrying` | Polymarket sends the trade to the chain again | | `Failed` | The trade did not settle. No shares changed hands | ### Use the bottom dock The dock is at the bottom of each page on a screen 768 px wide or more. It is not on a phone. It has three tabs, each with a count: **Positions**, **Orders** and **Fills today**. 1. Click a tab, or press `` ` ``, to open the dock. 2. Press `` ` `` again, or click the chevron, to close it. The dock closes when you go to **Portfolio** or **Orders**, because those pages show the same data. You can open it again there. | Tab | What it shows | | - | - | | **Positions** | **Size (sh)**, **Avg (¢)**, **Bid (¢)**, **Liq val ($)**, **P&L ($)** and **Orders** for each position, and an **Exit 21¢** button. A warning triangle before **Liq val (\$)** means that the bids cannot take the whole position | | **Orders** | Your open orders, newest first, with **Side**, **Price (¢)**, **Size (sh)**, **Filled (sh)**, **Status** and **Age**. **Status** reads `Open`, `Partial 20/50` or `Delayed 3s` | | **Fills today** | Today’s fills with **Value (\$)**, **Role** and **Status** | To use the dock keys: 1. Click the dock, or press `F6` until the dock has focus. 2. Press the key. | Tab | In Safe | Only while Armed | | - | - | - | | **Positions** | `↑` `↓` select a row. `↵` opens its market | `E` exit, `J` join, `A` add, `C` cancel the orders in its market | | **Orders** | `↑` `↓` move the cursor. `Space` selects a row. `Ctrl A` selects all | `[` `]` move the selected orders one tick. `Delete` cancels them | If no order is selected, `[`, `]` and `Delete` act on the order at the cursor. The same keys work on the **Orders** page. The [shortcuts](shortcuts.md) page lists every key. ## Good to know * **Rows do not move under your pointer.** While your pointer or finger is on the **Open** tab or the list of positions, new and re-sorted rows wait. A finished or cancelled order stays in its place, struck through. A pill such as `2 updates` counts the changes that wait. Move the pointer away, or click the pill, to show them. The values in the rows continue to update. * **Combos have their own tab.** See [Exit a combo](combos.md#exit-a-combo). * **Exposure.** The top bar’s **Exposure** is the liquidation value of your open positions plus what your open combos cost. Hover it to see the two parts. A combo has no book, so open combos are not in **Value (liq)**, **Unrealised P\&L** or **Cost basis**. * **Orders from polymarket.com.** The app shows only the orders that it placed. It does not show the orders that you place on polymarket.com. * **Order updates paused.** If the account feed disconnects, the top bar’s order count goes grey. **Orders** and the dock show `Order updates paused: the venue user feed is disconnected. Orders and fills show their last known state.` The lists update again when the feed reconnects. * **No venue credentials.** If **Orders** shows `No venue credentials` or `Venue credentials failed`, the app cannot read orders or fills. Positions still show. Tell the person who runs the server. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.