Skip to main content
Every endpoint that returns alerts uses this structure.

​
Fields

FieldTypeDescription
idintUnique ID
alert_typestringfresh, fresh_accumulator, or cluster
wallet_addressstringTrader’s address
market_idstringPolymarket contract ID
event_slugstringURL-safe market slug
event_titlestringMarket question
sidestringBUY or SELL
outcomestringYes, No, or named outcome
entry_pricefloatPrice paid (0.0–1.0)
usdc_valuefloatTrade size in USDC
signal_scoreint0–100 insider likelihood
trade_countintWallet’s total markets traded
categorystringSee Categories
created_atstringUTC timestamp
resolvedboolMarket has resolved
wonboolTrade was correct
profit_usdcfloatP&L after resolution
detailsobjectExtended data (see below)

​
Alert types

A wallet with little or no history making a significant trade. Fresh wallets are the strongest insider signal because they’re often created specifically to avoid detection.
A fresh wallet making multiple buys on the same market. Shows conviction. The details object includes:
{
  "is_accumulating": true,
  "market_buy_count": 4,
  "market_total_bought": 6200.0,
  "market_avg_price": 0.31
}
Multiple wallets buying the same outcome within a short window. Suggests coordination.
{
  "cluster_size": 5,
  "cluster_total_usdc": 12500.0,
  "cluster_wallets": ["0x1...", "0x2...", "0x3..."]
}

​
Full example

{
  "id": 2220,
  "alert_type": "fresh_accumulator",
  "wallet_address": "0x9B3b4e3bD0e9c72FF8b1A3cE7dA1f6BC3",
  "market_id": "0x1234...abcd",
  "event_slug": "us-strikes-iran-by-march-31-2026",
  "event_title": "US strikes Iran by March 31?",
  "side": "BUY",
  "outcome": "Yes",
  "entry_price": 0.19,
  "usdc_value": 1900.0,
  "signal_score": 80,
  "trade_count": 1,
  "category": "world",
  "created_at": "2026-02-27 11:35:26",
  "resolved": false,
  "won": null,
  "profit_usdc": null,
  "details": {
    "wallet_age_days": 2,
    "is_accumulating": true,
    "market_buy_count": 3,
    "market_total_bought": 4500.0,
    "market_avg_price": 0.22
  }
}