Position Change Event

Polymarket position transfers between wallets.

Emitted when conditional tokens are transferred between wallets (ERC-1155 TransferSingle or TransferBatch events on Polymarket’s CTF contract).

{
  "data": {
    "amount": 884.472711,
    "block_number": 84090735,
    "condition_id": "0x4295664a21b3c402905e20e7f7fe7b32f33ea65ee534044df4b02c78251aabaf",
    "event_title": "Ethereum Up or Down - March 12, 3:35AM-3:40AM ET",
    "event_type": "position_change",
    "from": "0xe041d09715148a9a4a7a881a5580da2c0701f2e5",
    "log_index": 518,
    "market_image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/ETH+fullsize.jpg",
    "market_slug": "eth-updown-5m-1773300900",
    "market_title": "Ethereum Up or Down - March 12, 3:35AM-3:40AM ET",
    "neg_risk": false,
    "outcome": "Up",
    "taker_base_fee": 1000.0,
    "tick_size": 0.01,
    "timestamp": 1773301503000,
    "to": "0x0000000000000000000000000000000000000000",
    "token_id": "88079040319084259792317169986778269594929895453001532385270733798362038010575",
    "tokens": {
      "16443073444374918605680266403165867352955585678993470305905845673667591889522": "Down",
      "88079040319084259792317169986778269594929895453001532385270733798362038010575": "Up"
    },
    "transfer_type": "single",
    "tx_hash": "0x2d2c4a493dff9b5912b327fcd680fe5ba0cbc7af6a6f3225a60bc63a895b3189"
  },
  "timestamp": 1773301503000,
  "type": "position_change"
}

Fields

type · string · required

Always "position_change".

timestamp · number · required

Block timestamp in Unix milliseconds.

data · object · required

Show data fields

tx_hash · string · required

Transaction hash.

block_number · number · required

Block number.

log_index · number · required

Log index within the transaction.

timestamp · number · required

Block timestamp in Unix milliseconds.

from · string · required

Sender wallet address.

to · string · required

Receiver wallet address.

token_id · string · required

Conditional token ID being transferred.

amount · number · required

Number of tokens transferred.

transfer_type · string · required

"single" (TransferSingle) or "batch" (TransferBatch).

market_title · string

Human-readable market question. Enriched from metadata.

outcome · string

Outcome name (e.g. “Yes”, “No”). Enriched from metadata.

market_slug · string

Market URL slug. Enriched from metadata.

event_title · string

Parent event title. Enriched from metadata.

market_image · string

Market image URL. Enriched from metadata.

neg_risk · boolean

Whether this market uses the negRisk contract type. Enriched from metadata.

tick_size · number

Minimum price increment (e.g. 0.01 or 0.001). Enriched from metadata.

taker_base_fee · number

Taker fee rate (e.g. 0.02 for 2%). Enriched from metadata.

condition_id · string

Market condition ID (CTF contract identifier). Enriched from metadata.

tokens · object

Map of token ID → outcome name for all outcomes in this market. Enriched from metadata.

Position changes from settlements are not duplicated here — the settlement event already contains the trade details. This event tracks non-trade transfers: wallet migrations, OTC deals, and smart contract interactions.