curl "https://polychadsbot.xyz/api/v1/hot-markets?period=1h&limit=5"
import requests
r = requests.get(
"https://polychadsbot.xyz/api/v1/hot-markets",
params={"period": "6h", "limit": 5, "category": "crypto"}
)
data = r.json()
print("🔥 HOTTEST MARKETS:")
for market in data["most_alerts"]:
print(f"- {market['event_title']}: {market['alert_count']} alerts, ${market['total_usdc']}")
const response = await fetch(
"https://polychadsbot.xyz/api/v1/hot-markets?period=24h&limit=10"
);
const { most_alerts, highest_signal, biggest_trades } = await response.json();
console.log("Whale markets:", biggest_trades);
{
"period": "24h",
"most_alerts": [
{
"market_id": "0x1234...abcd",
"event_title": "Will ETH hit $5000 by April?",
"event_slug": "eth-5000-april",
"category": "crypto",
"alert_count": 12,
"avg_signal": 68.5,
"total_usdc": 45200.0,
"latest_alert": "2026-03-01T10:15:22"
}
],
"highest_signal": [
{
"market_id": "0x5678...efgh",
"event_title": "US strikes Iran by March 31?",
"event_slug": "us-strikes-iran-by-march-31-2026",
"category": "world",
"alert_count": 4,
"avg_signal": 85.0,
"total_usdc": 18500.0,
"latest_alert": "2026-03-01T09:42:10"
}
],
"biggest_trades": [
{
"market_id": "0x9abc...ijkl",
"event_title": "Opinion FDV above $500M?",
"event_slug": "opinion-fdv-above-500m",
"category": "crypto",
"alert_count": 6,
"avg_signal": 72.3,
"total_usdc": 62100.0,
"latest_alert": "2026-03-01T10:08:44"
}
]
}
Hot Markets
Get Hot Markets
The absolute hottest markets right now, ranked by insider activity.
GET
/
hot-markets
curl "https://polychadsbot.xyz/api/v1/hot-markets?period=1h&limit=5"
import requests
r = requests.get(
"https://polychadsbot.xyz/api/v1/hot-markets",
params={"period": "6h", "limit": 5, "category": "crypto"}
)
data = r.json()
print("🔥 HOTTEST MARKETS:")
for market in data["most_alerts"]:
print(f"- {market['event_title']}: {market['alert_count']} alerts, ${market['total_usdc']}")
const response = await fetch(
"https://polychadsbot.xyz/api/v1/hot-markets?period=24h&limit=10"
);
const { most_alerts, highest_signal, biggest_trades } = await response.json();
console.log("Whale markets:", biggest_trades);
{
"period": "24h",
"most_alerts": [
{
"market_id": "0x1234...abcd",
"event_title": "Will ETH hit $5000 by April?",
"event_slug": "eth-5000-april",
"category": "crypto",
"alert_count": 12,
"avg_signal": 68.5,
"total_usdc": 45200.0,
"latest_alert": "2026-03-01T10:15:22"
}
],
"highest_signal": [
{
"market_id": "0x5678...efgh",
"event_title": "US strikes Iran by March 31?",
"event_slug": "us-strikes-iran-by-march-31-2026",
"category": "world",
"alert_count": 4,
"avg_signal": 85.0,
"total_usdc": 18500.0,
"latest_alert": "2026-03-01T09:42:10"
}
],
"biggest_trades": [
{
"market_id": "0x9abc...ijkl",
"event_title": "Opinion FDV above $500M?",
"event_slug": "opinion-fdv-above-500m",
"category": "crypto",
"alert_count": 6,
"avg_signal": 72.3,
"total_usdc": 62100.0,
"latest_alert": "2026-03-01T10:08:44"
}
]
}
Where is the smart money flowing? This endpoint aggregates our entire alert feed into three distinct leaderboard lists: Most Alerts, Highest Signal Score, and Biggest Trades.
This endpoint is completely public. No API key is required, making it incredibly easy to pull down into front-end dashboards.
string
default:"24h"
The time window to look back. Valid options:
1h, 6h, 24h, 7d, 30d.integer
default:"10"
Maximum items to return per leaderboard list (1–25).
string
Isolate to a specific category:
crypto, politics, world, tech, finance, pop_culture, other.What you get back
We return three arrays of market data, each sorted by a different core metric:| Leaderboard | Sorted by | When to use it |
|---|---|---|
most_alerts | Count (descending) | Finding where the highest volume of individual suspicious trades are happening. |
highest_signal | Avg score (descending) | Finding markets with the absolute strongest, most highly-coordinated insider conviction. |
biggest_trades | Total USDC (descending) | Following the literal whale money. |
Try it out
curl "https://polychadsbot.xyz/api/v1/hot-markets?period=1h&limit=5"
import requests
r = requests.get(
"https://polychadsbot.xyz/api/v1/hot-markets",
params={"period": "6h", "limit": 5, "category": "crypto"}
)
data = r.json()
print("🔥 HOTTEST MARKETS:")
for market in data["most_alerts"]:
print(f"- {market['event_title']}: {market['alert_count']} alerts, ${market['total_usdc']}")
const response = await fetch(
"https://polychadsbot.xyz/api/v1/hot-markets?period=24h&limit=10"
);
const { most_alerts, highest_signal, biggest_trades } = await response.json();
console.log("Whale markets:", biggest_trades);
{
"period": "24h",
"most_alerts": [
{
"market_id": "0x1234...abcd",
"event_title": "Will ETH hit $5000 by April?",
"event_slug": "eth-5000-april",
"category": "crypto",
"alert_count": 12,
"avg_signal": 68.5,
"total_usdc": 45200.0,
"latest_alert": "2026-03-01T10:15:22"
}
],
"highest_signal": [
{
"market_id": "0x5678...efgh",
"event_title": "US strikes Iran by March 31?",
"event_slug": "us-strikes-iran-by-march-31-2026",
"category": "world",
"alert_count": 4,
"avg_signal": 85.0,
"total_usdc": 18500.0,
"latest_alert": "2026-03-01T09:42:10"
}
],
"biggest_trades": [
{
"market_id": "0x9abc...ijkl",
"event_title": "Opinion FDV above $500M?",
"event_slug": "opinion-fdv-above-500m",
"category": "crypto",
"alert_count": 6,
"avg_signal": 72.3,
"total_usdc": 62100.0,
"latest_alert": "2026-03-01T10:08:44"
}
]
}
Authorizations
Your API key — get one from @chadsapibot on Telegram
Query Parameters
Time window
Available options:
1h, 6h, 24h, 7d, 30d Max items per list
Required range:
1 <= x <= 25Filter by category
Available options:
crypto, politics, world, tech, finance, pop_culture, other 
