curl -H "Authorization: Bearer YOUR_KEY_HERE" \
"https://polychadsbot.xyz/api/v1/alerts/latest?limit=2"
import requests
r = requests.get(
"https://polychadsbot.xyz/api/v1/alerts/latest",
headers={"Authorization": "Bearer YOUR_KEY_HERE"},
params={"limit": 2}
)
for alert in r.json():
print(f"🚨 {alert['side']} {alert['outcome']} on '{alert['event_title']}' for ${alert['usdc_value']}")
const response = await fetch(
"https://polychadsbot.xyz/api/v1/alerts/latest?limit=2",
{ headers: { Authorization: `Bearer YOUR_KEY_HERE` } }
);
const alerts = await response.json();
console.log(alerts);
[
{
"id": 2220,
"alert_type": "fresh_accumulator",
"wallet_address": "0x9B3b4e3bD0e9c72FF8b1A3c...",
"event_title": "US strikes Iran by March 31?",
"event_slug": "us-strikes-iran-by-march-31-2026",
"side": "BUY",
"outcome": "Yes",
"entry_price": 0.19,
"usdc_value": 1900.0,
"signal_score": 80,
"category": "world",
"trade_count": 1,
"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
}
}
]
Alerts
Get Latest Alerts
The absolute freshest insider alpha, ordered newest first.
GET
/
alerts
/
latest
curl -H "Authorization: Bearer YOUR_KEY_HERE" \
"https://polychadsbot.xyz/api/v1/alerts/latest?limit=2"
import requests
r = requests.get(
"https://polychadsbot.xyz/api/v1/alerts/latest",
headers={"Authorization": "Bearer YOUR_KEY_HERE"},
params={"limit": 2}
)
for alert in r.json():
print(f"🚨 {alert['side']} {alert['outcome']} on '{alert['event_title']}' for ${alert['usdc_value']}")
const response = await fetch(
"https://polychadsbot.xyz/api/v1/alerts/latest?limit=2",
{ headers: { Authorization: `Bearer YOUR_KEY_HERE` } }
);
const alerts = await response.json();
console.log(alerts);
[
{
"id": 2220,
"alert_type": "fresh_accumulator",
"wallet_address": "0x9B3b4e3bD0e9c72FF8b1A3c...",
"event_title": "US strikes Iran by March 31?",
"event_slug": "us-strikes-iran-by-march-31-2026",
"side": "BUY",
"outcome": "Yes",
"entry_price": 0.19,
"usdc_value": 1900.0,
"signal_score": 80,
"category": "world",
"trade_count": 1,
"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
}
}
]
Don’t want to mess with WebSockets but still need the latest action? Hit this endpoint to get the most recent alerts our engine has pumped out.
integer
default:"10"
How many of the latest alerts you want to pull. Max is 50.
Try it out
curl -H "Authorization: Bearer YOUR_KEY_HERE" \
"https://polychadsbot.xyz/api/v1/alerts/latest?limit=2"
import requests
r = requests.get(
"https://polychadsbot.xyz/api/v1/alerts/latest",
headers={"Authorization": "Bearer YOUR_KEY_HERE"},
params={"limit": 2}
)
for alert in r.json():
print(f"🚨 {alert['side']} {alert['outcome']} on '{alert['event_title']}' for ${alert['usdc_value']}")
const response = await fetch(
"https://polychadsbot.xyz/api/v1/alerts/latest?limit=2",
{ headers: { Authorization: `Bearer YOUR_KEY_HERE` } }
);
const alerts = await response.json();
console.log(alerts);
[
{
"id": 2220,
"alert_type": "fresh_accumulator",
"wallet_address": "0x9B3b4e3bD0e9c72FF8b1A3c...",
"event_title": "US strikes Iran by March 31?",
"event_slug": "us-strikes-iran-by-march-31-2026",
"side": "BUY",
"outcome": "Yes",
"entry_price": 0.19,
"usdc_value": 1900.0,
"signal_score": 80,
"category": "world",
"trade_count": 1,
"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
}
}
]
Authorizations
Your API key — get one from @chadsapibot on Telegram
Query Parameters
Number of alerts to return
Required range:
1 <= x <= 50Response
Array of alerts
Available options:
fresh, fresh_accumulator, cluster Available options:
BUY, SELL 
