Module	Description	Output Type
`map_exchange_events`	Extracts exchange trading events	`proto:polymarket.exchange.v1.ExchangeEvents`
`map_fee_events`	Extracts fee-related events	`proto:polymarket.exchange.v1.FeeEvents`
`map_admin_events`	Extracts admin role events	`proto:polymarket.exchange.v1.AdminEvents`
`map_pause_events`	Extracts user pause events	`proto:polymarket.exchange.v1.PauseEvents`
`map_approval_events`	Extracts order approval events	`proto:polymarket.exchange.v1.OrderApprovalEvents`
`map_all_events`	Extracts all exchange events	`proto:polymarket.exchange.v1.AllEvents`

Quick Start

Build the WASM binary:

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

Create the Substreams package:

make package-exchange
# or
cd polymarket-exchange && substreams pack

Run the Substreams:

make run-exchange
# or
substreams run substreams.yaml map_all_events \
  --network polygon \
  --start-block -1000

Event Types

The package extracts the following V2 event categories:

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.7
substreams-ethereum: ^0.11
ethabi: ^18

Binary Output

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

Documentation

map map_exchange_events

map map_fee_events

map map_admin_events

map map_pause_events

map map_approval_events

map map_all_events

map map_user_trades

blockIndex index_events

Modules

Maps

map
map_exchange_events

map map_exchange_events (

blocksf.ethereum.type.v2.Block

) -> polymarket.exchange.v1.ExchangeEvents

substreams gui polymarket-exchange@v0.8.0 map_exchange_events

map
map_fee_events

map map_fee_events (

blocksf.ethereum.type.v2.Block

) -> polymarket.exchange.v1.FeeEvents

substreams gui polymarket-exchange@v0.8.0 map_fee_events

map
map_admin_events

map map_admin_events (

blocksf.ethereum.type.v2.Block

) -> polymarket.exchange.v1.AdminEvents

substreams gui polymarket-exchange@v0.8.0 map_admin_events

map
map_pause_events

map map_pause_events (

blocksf.ethereum.type.v2.Block

) -> polymarket.exchange.v1.PauseEvents

substreams gui polymarket-exchange@v0.8.0 map_pause_events

map
map_approval_events

map map_approval_events (

blocksf.ethereum.type.v2.Block

) -> polymarket.exchange.v1.OrderApprovalEvents

substreams gui polymarket-exchange@v0.8.0 map_approval_events

map
map_all_events

map map_all_events (

blocksf.ethereum.type.v2.Block

) -> polymarket.exchange.v1.AllEvents

substreams gui polymarket-exchange@v0.8.0 map_all_events

map
map_user_trades

map map_user_trades (

paramsstring

blocksf.ethereum.type.v2.Block

) -> polymarket.exchange.v1.ExchangeEvents

Default param : trader:0x0000000000000000000000000000000000000000

substreams gui polymarket-exchange@v0.8.0 map_user_trades

Block Indexes

blockIndex
index_events

blockIndex index_events (

blocksf.ethereum.type.v2.Block

) -> sf.substreams.index.v1.Keys

Emits evt_addr:<address> for every block containing a CTF Exchange log, letting downstream modules skip blocks that never touch the contract.

substreams gui polymarket-exchange@v0.8.0 index_events

Protobuf Docs Explorer

sf.ethereum.type.v2

polymarket.exchange.v1

sf.ethereum.substreams.v1

sf.ethereum.transform.v1

Back to google.protobuf

// `Any` contains an arbitrary serialized protocol buffer message along with a URL that describes the type of the serialized message. Protobuf library provides support to pack/unpack Any values in the form of utility functions or additional generated methods of the Any type. Example 1: Pack and unpack a message in C++. Foo foo = ...; Any any; any.PackFrom(foo); ... if (any.UnpackTo(&foo)) { ... } Example 2: Pack and unpack a message in Java. Foo foo = ...; Any any = Any.pack(foo); ... if (any.is(Foo.class)) { foo = any.unpack(Foo.class); } Example 3: Pack and unpack a message in Python. foo = Foo(...) any = Any() any.Pack(foo) ... if any.Is(Foo.DESCRIPTOR): any.Unpack(foo) ... Example 4: Pack and unpack a message in Go foo := &pb.Foo{...} any, err := anypb.New(foo) if err != nil { ... } ... foo := &pb.Foo{} if err := any.UnmarshalTo(foo); err != nil { ... } The pack methods provided by protobuf library will by default use 'type.googleapis.com/full.type.name' as the type URL and the unpack methods only use the fully qualified type name after the last '/' in the type URL, for example "foo.bar.com/x/y.z" will yield type name "y.z". JSON The JSON representation of an `Any` value uses the regular representation of the deserialized, embedded message, with an additional field `@type` which contains the type URL. Example: package google.profile; message Person { string first_name = 1; string last_name = 2; } { "@type": "type.googleapis.com/google.profile.Person", "firstName": <string>, "lastName": <string> } If the embedded message type is well-known and has a custom JSON representation, that representation will be embedded adding a field `value` which holds the custom JSON in addition to the `@type` field. Example (for message [google.protobuf.Duration][]): { "@type": "type.googleapis.com/google.protobuf.Duration", "value": "1.212s" }

message Any {

optional string = 1;

optional bytes = 2;

}

Repository

Total Downloads

Published

Network

Publisher

Repository

Total Downloads

Published

Network

Publisher

Readme

Polymarket Exchange Substreams Package

Contract Information

Available Modules

Quick Start

Build the WASM binary:

Create the Substreams package:

Run the Substreams:

Event Types

Exchange Events

Fee Events

Admin Events

Pause Events

Order Approval Events

Dependencies

Binary Output

Documentation

Modules

mapmap_exchange_events

mapmap_fee_events

mapmap_admin_events

mapmap_pause_events

mapmap_approval_events

mapmap_all_events

mapmap_user_trades

blockIndexindex_events

Protobuf Docs Explorer

map
map_exchange_events

map
map_fee_events

map
map_admin_events

map
map_pause_events

map
map_approval_events

map
map_all_events

map
map_user_trades

blockIndex
index_events