Trigger Markets

Triggers whenever a trade happens on a specific Polymarket market. Useful for monitoring activity and reacting to trading in real time.

At a Glance

FieldValue
Trigger IDpolymarket-market-trade
CategoryMarkets
Tagspolymarket, prediction-market, trading, market-monitoring, websocket, real-time

Trigger Configuration

FieldTypeRequiredDescription
marketIdstringYesThe Polymarket market identifier. Accepts a condition ID (starts with 0x) or a market slug. To find the slug: open the market on polymarket.com and copy the last part of the URL after /event/ (e.g. polymarket.com/event/will-bitcoin-hit-100k → use 'will-bitcoin-hit-100k').
outcomestringNoOptional: filter by outcome. Only trades for this outcome will trigger.
minSizenumberNoMinimum trade size (in shares) to trigger on. Only trades >= this size will trigger.
sidestringNoFilter by trade side. If not specified, triggers on both BUY and SELL trades.

Trigger Result

FieldTypeRequiredDescription
triggeredAtstringYesTimestamp when the trade was detected (UTC, RFC3339 format)
marketobjectYesMarket information
tradeobjectYesDetails of the detected trade

Workflow Root Example

json
{ "nodes": { "root": { "type": "polymarket-market-trade", "payload": { "marketId": "will-bitcoin-hit-100k" }, "children": [ "log_event" ] }, "log_event": { "type": "log", "payload": { "message": "Triggered at {{$trigger.triggeredAt}}" }, "children": [] } }}

Downstream nodes can use {{$trigger.triggeredAt}} and any result fields listed above. Event triggers usually expose the raw source payload under a field such as event, body, trade, or raw.

Ask a question... ⌘I