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.

​
Filters

FilterTypeRequiredDescription
min_amount_usdnumberYesMinimum trade size in USD
condition_idsstring[]NoRestrict to specific markets
event_slugsstring[]NoRestrict to specific events
tagsstring[]NoRestrict to tagged markets

​
Payload

Same schema as trade, with "type": "large_trade". 
{
  "id": "evt_b3f2a1c0-8d4e-4f2a-9c1b-2e3f4a5b6c7d",
  "type": "large_trade",
  "created_at": "2026-05-14T14:56:30.123456789+00:00",
  "data": {
    "amount_usd": 1205.28,
    "price": 0.87,
    "direction": "BUY",
    "market": "Will Hyperliquid reach $48 in May?",
    "slug": "will-hyperliquid-reach-48-in-may",
    "outcome": "No",
    "maker": "0x337b7fca244bf2ef3272469ee02a2bd541097e26",
    "taker": "0x04b6d7e930cf9e493c5e6ef24b496294f95594c8",
    "condition_id": "0x...",
    "transaction_hash": "0x...",
    "order_hash": "0x...",
    "builder": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "fee_usd": 0.0,
    "timestamp": "1778770590"
  }
}

​
Use Cases

  • Whale alert bots (Discord, Telegram)
  • Smart money tracking
  • Unusual activity detection
  • Market sentiment signals

​
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-bot.com/whale-alerts",
    "event_types": ["large_trade"],
    "filters": {
      "min_amount_usd": 500,
      "tags": ["politics"]
    }
  }'

​
Verified Behavior

  • Threshold is inclusive: a $500.00 trade fires on min_amount_usd: 500
  • Trades below the threshold are silently skipped
  • Enrichment (market, outcome, slug) included on every delivery