Skip to main content
GET
/
alerts
curl -H "Authorization: Bearer YOUR_KEY_HERE" \
  "https://polychadsbot.xyz/api/v1/alerts?category=crypto&min_signal=80&min_usdc=5000&page=1"

{
  "alerts": [
    {
      "id": 2218,
      "alert_type": "fresh",
      "wallet_address": "0xcd5D...30D9",
      "market_id": "0x4441...890a",
      "event_title": "Opinion FDV above $500M?",
      "side": "BUY",
      "outcome": "Yes",
      "entry_price": 0.49,
      "usdc_value": 8500.0,
      "signal_score": 85,
      "category": "crypto",
      "created_at": "2026-02-27 11:10:12"
    }
  ],
  "total": 142,
  "page": 1,
  "page_size": 20,
  "has_more": true
}
Want to backtest a strategy? Need to find every whale buy on Crypto markets from last week? This is your endpoint. You can filter the entire Polychads database using the parameters below.
​
page
integer
default:"1"
The page number to fetch.
​
page_size
integer
default:"20"
How many results to pack into one page. Limits: Free: 20, Pro: 50, Enterprise: 100.
​
category
string
Isolate a specific market sector: crypto, politics, world, tech, finance, pop_culture, other.
​
side
string
Filter by action: BUY or SELL.
​
min_usdc
float
Only show trades larger than this USDC amount. Great for filtering out noise.
​
min_signal
integer
Only show alerts with a Signal Score equal to or higher than this (0-100).
​
q
string
Power search. Matches against the market question, market slug, or exact wallet address.

​
Try it out

curl -H "Authorization: Bearer YOUR_KEY_HERE" \
  "https://polychadsbot.xyz/api/v1/alerts?category=crypto&min_signal=80&min_usdc=5000&page=1"

{
  "alerts": [
    {
      "id": 2218,
      "alert_type": "fresh",
      "wallet_address": "0xcd5D...30D9",
      "market_id": "0x4441...890a",
      "event_title": "Opinion FDV above $500M?",
      "side": "BUY",
      "outcome": "Yes",
      "entry_price": 0.49,
      "usdc_value": 8500.0,
      "signal_score": 85,
      "category": "crypto",
      "created_at": "2026-02-27 11:10:12"
    }
  ],
  "total": 142,
  "page": 1,
  "page_size": 20,
  "has_more": true
}

Authorizations

​
Authorization
string
header
required

Your API key — get one from @chadsapibot on Telegram

Query Parameters

​
page
integer
default:1

Page number

​
page_size
integer
default:20

Results per page

​
category
enum<string>

Filter by category

Available options:
crypto,
politics,
world,
tech,
finance,
pop_culture,
other
​
side
enum<string>

Filter by trade direction

Available options:
BUY,
SELL
​
min_usdc
number

Minimum trade size in USDC

​
min_signal
integer

Minimum signal score

Required range: 0 <= x <= 100
​
q
string

Text search — matches market title, slug, or wallet address

Response

200 - application/json

Paginated alerts

​
alerts
object[]
​
total
integer
​
page
integer
​
page_size
integer
​
has_more
boolean