Position Change Event

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

{
  "data": {
    "amount": 0.050921,
    "block_number": 84697556,
    "condition_id": "0xc288913391d7d3b484d9e63f60996671a1888207e0d9917691c5257cbab09309",
    "event_title": "Bitcoin Up or Down - March 26, 4:50AM-4:55AM ET",
    "event_type": "position_change",
    "from": "0xe3f18acc55091e2c48d883fc8c8413319d4ab7b0",
    "log_index": 2147,
    "market_image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/BTC+fullsize.png",
    "market_slug": "btc-updown-5m-1774515000",
    "market_title": "Bitcoin Up or Down - March 26, 4:50AM-4:55AM ET",
    "neg_risk": false,
    "outcome": "Up",
    "outcomes": ["Up", "Down"],
    "taker_base_fee": 1000.0,
    "tick_size": 0.01,
    "timestamp": 1774515147000,
    "to": "0xb27bc932bf8110d8f78e55da7d5f0497a18b5b82",
    "token_id": "58779171378753040273547833889411100281640930430837040192014777442237090167078",
    "token_ids": [
      "58779171378753040273547833889411100281640930430837040192014777442237090167078",
      "44910406836464179003614524044201701268382942629198430107881894265432491492514"
    ],
    "tokens": {
      "44910406836464179003614524044201701268382942629198430107881894265432491492514": "Down",
      "58779171378753040273547833889411100281640930430837040192014777442237090167078": "Up"
    },
    "transfer_type": "single",
    "tx_hash": "0x2b72f18ba36846fa72c7083e89d1a66438e0b9b15e170325f4efde5d08cc602e"
  },
  "timestamp": 1774515147000,
  "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.

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 in basis points. 200 = 2%, 1000 = 10%, null = no fee. Short-term crypto markets (5-minute ETH/BTC) typically have 1000 (10%), while standard markets have 200 (2%). Enriched from Polymarket metadata.

condition_id

string

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

outcomes

string[]

Ordered list of outcome names (e.g. ["Yes", "No"]). Index-aligned with token_ids. Enriched from metadata.

token_ids

string[]

Ordered list of token IDs for this market. Index-aligned with outcomes. 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.

​Fields

Fields