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 eth_common:all_events

blockIndex eth_common: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.10.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.10.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.10.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.10.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.10.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.10.0 map_all_events

map
eth_common:all_events

map eth_common:all_events (

blocksf.ethereum.type.v2.Block

) -> sf.substreams.ethereum.v1.Events

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

substreams gui polymarket-exchange@v0.10.0 eth_common:all_events

Block Indexes

blockIndex
eth_common:index_events

blockIndex eth_common:index_events (

eth_common:all_events sf.substreams.ethereum.v1.Events

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

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)

substreams gui polymarket-exchange@v0.10.0 eth_common: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

mapeth_common:all_events

blockIndexeth_common:index_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
eth_common:all_events

blockIndex
eth_common:index_events