Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.polynode.dev/llms.txt

Use this file to discover all available pages before exploring further.

​
Endpoint

POST /v3/webhooks

​
Request Body

FieldTypeRequiredDescription
urlstringYesDelivery URL (must start with https://)
event_typesstring[]YesEvent types to subscribe to (see event types)
filtersobjectNoFilter criteria (see below)
secretstringNoHMAC signing secret. Auto-generated if omitted.
descriptionstringNoHuman-readable label

​
Filter Object

All filter fields are optional. Empty or omitted filters match everything for that dimension. Multiple filters are AND’d together. 
{
  "wallet_addresses": ["0x1234..."],
  "token_ids": ["12345..."],
  "condition_ids": ["0xabcd..."],
  "event_slugs": ["us-presidential-election"],
  "tags": ["politics", "crypto"],
  "builder_codes": ["0x5678..."],
  "receiver_addresses": ["0x9abc..."],
  "min_amount_usd": 100,
  "min_fee_usd": 1.0,
  "min_delta_pct": 5.0,
  "min_pnl_change_usd": 50.0,
  "min_total_usd": 500,
  "side": "BUY"
}

​
Example

curl -X POST https://api.polynode.dev/v3/webhooks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-app.com/hooks/polymarket",
    "event_types": ["trade", "redemption"],
    "filters": {
      "wallet_addresses": ["0x6d3c5bd13984b2de47c3a88ddc455309aab3d294"],
      "min_amount_usd": 100
    },
    "description": "Track whale trades and redemptions"
  }'

​
Response (201 Created)

{
  "id": "wh_451e06ca0534",
  "url": "https://your-app.com/hooks/polymarket",
  "event_types": ["trade", "redemption"],
  "filters": {
    "wallet_addresses": ["0x6d3c5bd13984b2de47c3a88ddc455309aab3d294"],
    "min_amount_usd": 100
  },
  "secret": "whsec_0e4535d1565e4e4d9e24debf3e40f836",
  "active": true,
  "description": "Track whale trades and redemptions",
  "created_at": "2026-05-14T14:54:08.019035820+00:00"
}
Save the secret value — it is only returned on creation. You’ll need it to verify webhook signatures.