curl -H "Authorization: Bearer YOUR_KEY_HERE" \
"https://polychadsbot.xyz/api/v1/alerts?category=crypto&min_signal=80&min_usdc=5000&page=1"
import requests
r = requests.get(
"https://polychadsbot.xyz/api/v1/alerts",
headers={"Authorization": "Bearer YOUR_KEY_HERE"},
params={"category": "crypto", "min_signal": 80, "min_usdc": 5000}
)
data = r.json()
print(f"Found {data['total']} alerts matching your criteria.")
{
"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
}
Alerts
Get Alerts
Search, filter, and paginate through the full historical archive of insider alerts.
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"
import requests
r = requests.get(
"https://polychadsbot.xyz/api/v1/alerts",
headers={"Authorization": "Bearer YOUR_KEY_HERE"},
params={"category": "crypto", "min_signal": 80, "min_usdc": 5000}
)
data = r.json()
print(f"Found {data['total']} alerts matching your criteria.")
{
"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.
integer
default:"1"
The page number to fetch.
integer
default:"20"
How many results to pack into one page.
Limits: Free: 20, Pro: 50, Enterprise: 100.
string
Isolate a specific market sector:
crypto, politics, world, tech, finance, pop_culture, other.string
Filter by action:
BUY or SELL.float
Only show trades larger than this USDC amount. Great for filtering out noise.
integer
Only show alerts with a Signal Score equal to or higher than this (0-100).
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"
import requests
r = requests.get(
"https://polychadsbot.xyz/api/v1/alerts",
headers={"Authorization": "Bearer YOUR_KEY_HERE"},
params={"category": "crypto", "min_signal": 80, "min_usdc": 5000}
)
data = r.json()
print(f"Found {data['total']} alerts matching your criteria.")
{
"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
Your API key — get one from @chadsapibot on Telegram
Query Parameters
Page number
Results per page
Filter by category
Available options:
crypto, politics, world, tech, finance, pop_culture, other Filter by trade direction
Available options:
BUY, SELL Minimum trade size in USDC
Minimum signal score
Required range:
0 <= x <= 100Text search — matches market title, slug, or wallet address