Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.outcome.xyz/llms.txt

Use this file to discover all available pages before exploring further.

Once you have open positions, your portfolio page is where you track them. This covers what you’ll see, how to interpret it, and how to manage existing positions.

​
Your portfolio

Every filled order creates or adds to a position. The portfolio view shows each open position with:
  • The market and outcome you’re holding.
  • Your position size (how many tokens).
  • Your average entry price.
  • The current market price.
  • Your unrealized gain or loss.
If you’ve traded the same outcome multiple times at different prices, the position is aggregated, and your average entry is the size-weighted average across all your fills.
Your full trade history (filled orders, closes, and settlements) appears in the Trade History tab.

​
Cost basis and average entry

Your cost basis is the total amount you’ve paid for a position. If you bought 100 tokens at ¢40, your cost basis is 40 USDH. If you then bought 50 more tokens at ¢50, your cost basis is 65 USDH (40 + 25), and your average entry price is ¢43.333. Cost basis is what you’d need to recover to break even at settlement.

​
Realized vs unrealized gains and losses

Unrealized gains and losses are the difference between your average entry price and the current market price, applied to your remaining position size. These move continuously as the market price moves and don’t reflect any actual proceeds. Realized gains and losses are locked in when you close a position (in full or in part) or when a market settles. They become real changes to your USDH balance. If you bought 100 tokens at ¢40 and the price is now ¢60, your unrealized gain is 20 USDH. If you sell those 100 tokens at ¢60, that 20 USDH becomes realized.
A market close can realize a different amount than the unrealized figure shows. If your order walks through multiple levels of the book, the average fill price is lower (or higher) than the best price displayed, and your realized gain or loss differs from the unrealized estimate. See Order lifecycle for slippage detail.

​
Closing a partial position

You don’t have to close a full position at once. Selling fewer tokens than you hold leaves the rest open. For example, if you hold 100 tokens with an average entry of ¢40 and sell 60 at ¢60, you realize a gain of 12 USDH on the 60 sold (60 × (¢60 − ¢40) ÷ 100). The remaining 40 tokens stay open at the same ¢40 average entry, with their own unrealized gain or loss based on the current market price. Partial closes are useful for:
  • Taking gains progressively.
  • Reducing exposure without exiting entirely.
  • Freeing up capital for other trades.

​
Positions across recurring market instances

For recurring markets like the daily BTC binary, each instance is a separate market with separate tokens. When today’s instance settles, the next instance is already open with new tokens. Holding a position through settlement does not extend into the new instance. Your tokens settle (at 1 or 0 per token), proceeds go to your USDH balance, and any further exposure requires a new trade in the next instance’s market.
See Recurring markets for more on how these markets work.

​
Formulas

For each open position, the math behind what you see in your portfolio.
Note on units: the UI displays prices in cents (e.g., ¢40). In the formulas below, prices are expressed as decimal USDH values: ¢40 = 0.40, ¢99.999 = 0.99999. All resulting amounts (cost basis, PnL, payoff) are in USDH.
Average entry price average entry=total spent on buystotal tokens bought\text{average entry} = \frac{\text{total spent on buys}}{\text{total tokens bought}} The size-weighted average across all your buys of the same outcome. Cost basis (of current position) cost basis=average entry×tokens held\text{cost basis} = \text{average entry} \times \text{tokens held} What you’ve paid for the tokens you still hold. Unrealized gain or loss unrealized PnL=(current price−average entry)×tokens held\text{unrealized PnL} = (\text{current price} - \text{average entry}) \times \text{tokens held} The paper value of your position right now. Realized gain or loss on a sale realized PnL=(sale price−average entry)×tokens sold\text{realized PnL} = (\text{sale price} - \text{average entry}) \times \text{tokens sold} Locked in when you close part or all of a position. Settlement payoff payoff per token={1 USDHif your outcome resolves0otherwise\text{payoff per token} = \begin{cases} 1 \text{ USDH} & \text{if your outcome resolves} \\ 0 & \text{otherwise} \end{cases} total payoff=tokens held×payoff per token\text{total payoff} = \text{tokens held} \times \text{payoff per token} What you receive automatically when the market resolves.