Skip to main content

A Position plus its orders, newest first.

​
id
string
required

The position id (prefix pos_). One position per market: a market you re-enter after closing reuses it.

Example:

"pos_6aedec66d4a9e2c7f1b05d38a6e2c9b1"

​
market_id
string
required

The market the position is in.

Example:

"pm_6ae1e3c09e1d4c7a2b5f80e3d6a9c412"

​
realized_pnl
number
required

Profit or loss locked in, in dollars after all fees, rounded to cents: on contracts sold, proceeds minus cost; once the market settles, the payout plus sale proceeds minus every cost and fee.

Example:

0.58

​
created_at
integer<int64>
required

When the position was opened. Epoch milliseconds.

Example:

1793977446412

​
updated_at
integer<int64>
required

When the position last changed. Epoch milliseconds.

Example:

1794166871236

​
status
enum<string>
required

open while you hold contracts; closed once you hold none. See Position statuses.

Available options:
open,
closed
Example:

"closed"

​
side
enum<string>
required

The side you hold: yes or no. When nothing is open, the side of the first order. See Order sides.

Available options:
yes,
no
Example:

"yes"

​
price
number
required

Average price paid per open contract including fees, in dollars rounded to cents. 0 when nothing is open. Rounded, so it does not multiply back out to cost_plus_fees; read the dollar fields for amounts.

Example:

0.6

​
cost
number
required

Cost of the open contracts excluding fees, in dollars rounded to cents. 0 when nothing is open.

Example:

5.85

​
quantity
integer
required

Contracts held now. 0 on a closed position.

Example:

10

​
order_count
integer
required

The number of buy orders in orders. From GET /positions/{id} that is the executed buys; from GET /positions/market/{market_id}, whose orders include pending orders, a buy still pending is counted too. Sells are not counted.

Example:

1

​
market
Market · object
required

The market as it stands now, with live_stat on a player prop.

Example:
​
cost_plus_fees
number
required

cost plus total_fees, rounded to cents. 0 when nothing is open.

Example:

5.97

​
total_fees
number
required

Fees on all of the position's executed orders, buys and sells, in dollars rounded to cents.

Example:

0.12

​
closed_cost
number
required

Cost of the contracts closed out (sold, or settled), excluding fees, in dollars rounded to cents.

Example:

5.85

​
closed_cost_plus_fees
number
required

closed_cost plus the fees paid when those contracts were bought, rounded to cents. Fees paid on the sale are not included.

Example:

5.97

​
closed_quantity
integer
required

Contracts closed out, by sale or settlement.

Example:

10

​
total_proceeds
number
required

Dollars you received: sale proceeds net of their fees, plus the settlement payout once the market settles. Rounded to cents.

Example:

6.55

​
orders
Order · object[]
required

The position's orders, newest first. From GET /positions/{id}, the orders that are neither pending nor cancelled. From GET /positions/market/{market_id}, every order that is not cancelled, so an order still pending appears.

​
closed_at
integer<int64>

When the position closed. Epoch milliseconds. Absent while it has never closed, and cleared when a closed position reopens.

Example:

1794166871236

​
closed_price
number

Average price per closed contract including the opening fees: closed_cost_plus_fees / closed_quantity, rounded to cents. Absent while nothing has closed.

Example:

0.6