All packages
polymarket-exchange

polymarket-exchange

colindickson
v1.2.0/7 downloads/Repository

Package ref

polymarket-exchange@v1.2.0
Download .spkg

Run package

CLI

Run map_exchange_events from the command line.

substreams run polymarket-exchange@v1.2.0 map_exchange_events -e polygon --start-block -1
Authenticate by running substreams auth or directly on thegraph.market (see docs).

README

Polymarket Exchange Substreams Package

Substreams package for extracting events from the Polymarket exchange contracts on Polygon: CTF Exchange V2 and the Protocol V2 Exchange ("ExchangeV3").

Contract Information

ContractAddressexchange field
CTF Exchange V20xE111180000d2663C0091e4f400237545B87B996Bctf_v2
Protocol V2 Exchange (ExchangeV3, proxy)0xe3333700cA9d93003F00f0F71f8515005F6c00Aaexchange_v3
  • Network: Polygon
  • Initial block: 84902353 (CTF Exchange V2). ExchangeV3 was deployed after it (its address is listed in Polymarket's polymarket-v2-external README as of 2026-09-24; the exact deployment block isn't pinned here), so the initial block covers both.

Both contracts emit the same event signatures, so every module reads both and every event carries an exchange field saying which one emitted it. ExchangeV3 token_ids are Protocol V2 PositionManager position ids, not Conditional Tokens ERC1155 ids.

Available Modules

ModuleDescriptionOutput Type
map_exchange_eventsExtracts exchange trading eventsproto:polymarket.exchange.v1.ExchangeEvents
map_fee_eventsExtracts fee-related eventsproto:polymarket.exchange.v1.FeeEvents
map_admin_eventsExtracts admin role eventsproto:polymarket.exchange.v1.AdminEvents
map_pause_eventsExtracts user pause eventsproto:polymarket.exchange.v1.PauseEvents
map_approval_eventsExtracts order approval eventsproto:polymarket.exchange.v1.OrderApprovalEvents
map_all_eventsExtracts all exchange eventsproto:polymarket.exchange.v1.AllEvents

Quick Start

Build the WASM binary:

make build-exchange
# or
cd polymarket-exchange && substreams build

Create the Substreams package:

cd polymarket-exchange && substreams pack

Run the Substreams:

substreams run substreams.yaml map_all_events \
  --network polygon \
  --start-block -1000

Event Types

The package extracts the following event categories. ExchangeV3 emits the exchange, fee, pause and order approval events; the admin events (and FeeReceiverUpdated, MaxFeeRateUpdated) only come from CTF Exchange V2.

Exchange Events

  • OrderFilled - Order filled (with side uint8, token_id, builder, metadata)
  • OrdersMatched - Orders matched (with side uint8, token_id)

Fee Events

  • FeeCharged - Trading fee charged (recipient, amount)
  • FeeReceiverUpdated - Fee receiver address changed
  • MaxFeeRateUpdated - Maximum fee rate changed

Admin Events

  • NewAdmin - New admin added
  • NewOperator - New operator added
  • RemovedAdmin - Admin removed
  • RemovedOperator - Operator removed

Pause Events

  • UserPaused - User paused from trading
  • UserUnpaused - User unpaused
  • UserPauseBlockIntervalUpdated - Pause interval changed

Order Approval Events

  • OrderPreapproved - Order preapproved
  • OrderPreapprovalInvalidated - Order preapproval invalidated

Dependencies

  • substreams: ^0.8
  • substreams-ethereum: ^0.12
  • buffa: 0.9

Binary Output

Build artifacts: target/wasm32-unknown-unknown/release/polymarket_exchange.wasm

Modules

Execution graph

8 modules
Show 2 dependencies
map

eth_common:all_events

`all_events` gives you all the events in a block (from successful transactions), with basic block hash/number/timestamp and transaction hash

Output

sf.substreams.ethereum.v1.Events

Inputs

sf.ethereum.type.v2.Block
blockIndex

eth_common:index_events

`index_events` sets the following keys on the block: * Event signatures evt_sig:0x0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef (signature in hex, prefixed by 0x) * Event address evt_addr:0x0123456789abcdef0123456789abcdef01234567 (address in hex, prefixed by 0x)

Output

sf.substreams.index.v1.Keys

Inputs

eth_common:all_events