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.
Outcome tokens (shares) currently held.
Average entry price per share of the current holding, in USDC (between 0 and 1).
Cost basis of the current holding, in USDC (amount * avg_price).
Cumulative realized profit or loss from sells and redemptions of this token, in USDC.
Cumulative shares of this token ever bought. Unlike
amount, this does not decrease when shares are sold.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.
