Skip to main content
GET
/
hot-markets
curl "https://polychadsbot.xyz/api/v1/hot-markets?period=1h&limit=5"

{
  "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.
​
period
string
default:"24h"
The time window to look back. Valid options: 1h, 6h, 24h, 7d, 30d.
​
limit
integer
default:"10"
Maximum items to return per leaderboard list (1–25).
​
category
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:
LeaderboardSorted byWhen to use it
most_alertsCount (descending)Finding where the highest volume of individual suspicious trades are happening.
highest_signalAvg score (descending)Finding markets with the absolute strongest, most highly-coordinated insider conviction.
biggest_tradesTotal USDC (descending)Following the literal whale money.

​
Try it out

curl "https://polychadsbot.xyz/api/v1/hot-markets?period=1h&limit=5"

{
  "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

​
Authorization
string
header
required

Your API key — get one from @chadsapibot on Telegram

Query Parameters

​
period
enum<string>
default:24h

Time window

Available options:
1h,
6h,
24h,
7d,
30d
​
limit
integer
default:10

Max items per list

Required range: 1 <= x <= 25
​
category
enum<string>

Filter by category

Available options:
crypto,
politics,
world,
tech,
finance,
pop_culture,
other

Response

200 - application/json

Three ranked lists of hot markets

​
period
string
​
most_alerts
object[]
​
highest_signal
object[]
​
biggest_trades
object[]