List webhooks

Retrieve a paginated list of your webhook subscriptions with optional filtering

GET /webhooks

List webhooks

cURL

curl --request GET \
  --url https://api.struct.to/v1/webhooks

200

{
  "webhooks": [
    {
      "id": "<string>",
      "url": "<string>",
      "created_at": 123,
      "updated_at": 123,
      "has_secret": true,
      "filters": {
        "wallet_addresses": [
          "<string>"
        ],
        "traders": [
          "<string>"
        ],
        "condition_ids": [
          "<string>"
        ],
        "min_usd_value": 123,
        "event_slugs": [
          "<string>"
        ],
        "tags": [
          "<string>"
        ],
        "series_slugs": [
          "<string>"
        ],
        "min_price": 123,
        "max_price": 123,
        "min_realized_pnl_usd": 123,
        "max_realized_pnl_usd": 123,
        "min_volume_usd": 123,
        "max_volume_usd": 123,
        "min_liquidity_usd": 123,
        "max_liquidity_usd": 123,
        "min_buy_usd": 123,
        "min_win_rate": 123,
        "min_markets_traded": 123,
        "min_net_shares": 123,
        "max_net_shares": 123,
        "position_ids": [
          "<string>"
        ],
        "outcomes": [
          "<string>"
        ],
        "position_outcome_indices": [
          1
        ],
        "trade_types": [
          "<string>"
        ],
        "min_fees": 123,
        "min_txns": 123,
        "min_unique_traders": 123,
        "min_sell_volume_usd": 123,
        "min_price_change_pct": 123,
        "min_probability_change_pct": 123,
        "timeframes": [],
        "milestone_amounts": [
          123
        ],
        "spike_ratio": 123,
        "exclude_shortterm_markets": true,
        "asset_symbols": [],
        "window_secs": 1,
        "oracle_event_types": [
          "<string>"
        ],
        "one_shot": true,
        "fire_if_already_past": true
      },
      "description": "<string>",
      "credits_used_24h": 123
    }
  ],
  "total": 1
}

Query Parameters

limit · integer<int32>

Results per page (default: 20, max: 100)

offset · integer<int32>

Pagination offset (default: 0)

status · enum<string>

Filter by status: active, paused Webhook status

Available options: active, paused

event · enum<string>

Filter by event type Polymarket webhook event types

Available options: trader_first_trade, trader_new_market, trader_whale_trade, trader_new_trade, trader_trade_event, trader_global_pnl, trader_market_pnl, trader_category_pnl, trader_position_resolved, trader_exit_markers, position_holder_metrics, condition_holder_metrics, event_holder_metrics, condition_metrics, event_metrics, tag_metrics, position_metrics, position_liquidity, market_liquidity, event_liquidity, market_volume_milestone, event_volume_milestone, position_volume_milestone, market_volume_spike, event_volume_spike, position_volume_spike, close_to_bond, market_created, asset_price_tick, asset_price_window_update, price_spike, probability_spike, oracle_events, price_threshold, market_resolved, market_disputed

Response

200

application/json

List of webhooks

List webhooks response

webhooks · object[] · required

List of webhooks

Show child attributes

total · integer · required

Total count

Required range: x >= 0