Skip to main content

​
Overview

Filter orders by specific condition IDs to track trades for particular market conditions. This is useful when you want to monitor specific outcomes or tokens within markets.

​
Subscription Format

{
    "action": "subscribe",
    "platform": "polymarket",
    "version": 1,
    "type": "orders",
    "filters": {
        "condition_ids": [
            "0x17815081230e3b9c78b098162c33b1ffa68c4ec29c123d3d14989599e0c2e113"
        ]
    }
}

​
Parameters

  • action: Must be "subscribe"
  • platform: Must be "polymarket"
  • version: Currently 1
  • type: Must be "orders"
  • filters.condition_ids: Array of condition ID strings (hex format starting with 0x)

​
Multiple Condition IDs

You can track multiple conditions in a single subscription: 
{
    "action": "subscribe",
    "platform": "polymarket",
    "version": 1,
    "type": "orders",
    "filters": {
        "condition_ids": [
            "0x17815081230e3b9c78b098162c33b1ffa68c4ec29c123d3d14989599e0c2e113",
            "0x592b8a416cbe36aa7bb40df85a61685ebd54ebbd2d55842f1bb398cae4f40dfc"
        ]
    }
}
You’ll receive order events when trades occur for any of the specified condition IDs.

​
Example Response

When an order matching your filter is executed, you’ll receive: 
{
    "type": "event",
    "subscription_id": "sub_m58zfduokmd",
    "data": {
        "token_id": "57564352641769637293436658960633624379577489846300950628596680893489126052038",
        "side": "BUY",
        "market_slug": "btc-updown-15m-1762755300",
        "condition_id": "0x17815081230e3b9c78b098162c33b1ffa68c4ec29c123d3d14989599e0c2e113",
        "shares": 5000000,
        "shares_normalized": 5,
        "price": 0.54,
        "tx_hash": "0xd94d999336c1f579359044e2bc5fba863f240ee07ef1c6713ff69e09b67b3b13",
        "title": "Bitcoin Up or Down - November 10, 1:15AM-1:30AM ET",
        "timestamp": 1762755335,
        "order_hash": "0xf504516ab54ea46f41eaf2852f41c328e6234928f3fcfe01a9172a5908839421",
        "user": "0x6031b6eed1c97e853c6e0f03ad3ce3529351f96d"
    }
}
The condition_id field in the response will match one of the condition IDs from your subscription filter.

​
Use Cases

  • Monitor specific tokens or outcomes within a market
  • Track trading activity for particular conditions
  • Build analytics dashboards for specific market conditions
  • Create alerts for trades on specific conditions