Trade Event

Confirmed on-chain trade execution from Polymarket exchange contracts.

A confirmed on-chain trade from Polymarket’s exchange contracts.

{
  "data": {
    "block_number": 84090704,
    "condition_id": "0xab3eea0d5b61cd443affca5fcd19d3541e92f7c96f7e92111982fbcbff56bb55",
    "event_title": "Bitcoin Up or Down - March 12, 3:40AM-3:45AM ET",
    "event_type": "trade",
    "exchange": "ctf_exchange",
    "log_index": 767,
    "maker": "0x1e3cb16886d605430a8c5581eddd08e068c08a62",
    "maker_amount": "3690307",
    "market_image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/BTC+fullsize.png",
    "market_slug": "btc-updown-5m-1773301200",
    "market_title": "Bitcoin Up or Down - March 12, 3:40AM-3:45AM ET",
    "neg_risk": false,
    "outcome": "Up",
    "price": 0.711,
    "side": "BUY",
    "size": 5.19,
    "taker": "0xb9b31d3872d3b14d67d0949642ff13d925b1ab4a",
    "taker_amount": "5190306",
    "taker_base_fee": 1000.0,
    "tick_size": 0.01,
    "timestamp": 1773301441000,
    "token_id": "47635040450827094965464370243227927750353541381049355332417378831540287352201",
    "tokens": {
      "47635040450827094965464370243227927750353541381049355332417378831540287352201": "Up",
      "57924371746740845060329991315866785058480643549619724503463886953768356812176": "Down"
    },
    "tx_hash": "0x74dbde22f31ce8dcbc5b3c187c33cd131d9bb5791874e139b41c1049ae3589fc"
  },
  "timestamp": 1773301441000,
  "type": "trade"
}

Fields

type · string · required

Always "trade".

timestamp · number · required

Unix milliseconds of the block.

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. (tx_hash, log_index) is globally unique.

timestamp · number · required

Block timestamp in Unix milliseconds.

exchange · string · required

"ctf_exchange" or "neg_risk_ctf_exchange".

maker · string · required

Maker wallet address.

taker · string · required

Taker wallet address.

token_id · string · required

Conditional token ID.

side · string · required

"BUY" or "SELL".

price · number · required

Fill price (0.0–1.0 for binary markets).

size · number · required

Fill size in shares.

maker_amount · string · required

Raw maker amount (6 decimal precision).

taker_amount · string · required

Raw taker amount (6 decimal precision).

market_title · string

Market question. Enriched from metadata.

outcome · string

Outcome name. Enriched from metadata.

market_slug · string

Market URL slug. Enriched from metadata.

market_image · string

Market image URL. Enriched from metadata.

event_title · string

Parent event title. 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 (e.g. {"123...": "Yes", "456...": "No"}). Enriched from metadata.

Settlement vs trade

	Settlement	Trade
Source	Pre-chain detection	On-chain confirmation
Timing	Pending (pre-chain) or confirmed	Confirmed only
Contains	Full settlement with all maker fills	Single maker-taker fill
Use case	Early detection, copy trading	Accurate historical record

A single settlement can contain multiple trades (one per matched maker order). If you subscribe to both settlement and trade, you’ll see the settlement first (pending), then individual trades (confirmed).