Skip to main content
Messagefields15topicpredictions-positions

Fields

The number on the right of each row is the protobuf field number.
user_idint641
Internal numeric id of the user’s wallet. Same id space as PredictionsTrade.maker_id/taker_id and PredictionsInsider.user_id.
asset_idint642
Internal numeric id of the outcome token. Same id space as PredictionsTrade.asset_id and PredictionsInsider.asset_id.
user_addressstring3
User wallet address (0x-prefixed hex).
asset_addressstring4
Polymarket CTF (ERC-1155) token id of the outcome token, as a decimal string. Note: despite the name this is a token id, not a 0x contract address. It matches PredictionsTrade.asset_address and PredictionsInsider.token_id.
amountDecimal5
Outcome tokens (shares) currently held.
avg_priceDecimal6
Average entry price per share of the current holding, in USDC (between 0 and 1).
invested_usdDecimal7
Cost basis of the current holding, in USDC (amount * avg_price).
realized_pnlDecimal8
Cumulative realized profit or loss from sells and redemptions of this token, in USDC.
total_boughtDecimal9
Cumulative shares of this token ever bought. Unlike amount, this does not decrease when shares are sold.
total_invested_usdDecimal10
Cumulative USDC ever spent buying this token. Unlike invested_usd, this does not decrease when shares are sold.
updated_atint6411
Currently not populated (always 0). Reserved for the time the position was last updated.
first_traded_atint64optional12
Approximate time of the user’s first trade in this token, Unix epoch milliseconds, UTC. Estimated from the block number using the average Polygon block time, so it can drift by a few minutes.
last_blockint6413
Polygon block number at which this position state took effect. In this stream it equals block_start.
block_startint6414
First Polygon block of the range in which this position state is valid (inclusive).
block_endint6415
Last Polygon block of the validity range (exclusive). 0 while this is the latest state of the position.
Last modified on September 23, 2026