Skip to main content
GET
/
alerts
/
latest
curl -H "Authorization: Bearer YOUR_KEY" \
  "https://polychadsbot.xyz/api/v1/alerts/latest?limit=2"
[
  {
    "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
    }
  }
]
Returns the latest alerts, sorted newest first.
limit
integer
default:"10"
How many to return. Max 50.
curl -H "Authorization: Bearer YOUR_KEY" \
  "https://polychadsbot.xyz/api/v1/alerts/latest?limit=2"
[
  {
    "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

Authorization
string
header
required

Your API key — get one from @alrerat on Telegram

Query Parameters

limit
integer
default:10

Number of alerts to return

Required range: 1 <= x <= 50

Response

Array of alerts

id
integer
alert_type
enum<string>
Available options:
fresh,
fresh_accumulator,
cluster
wallet_address
string
event_title
string
event_slug
string
market_id
string
side
enum<string>
Available options:
BUY,
SELL
outcome
string
entry_price
number
usdc_value
number
signal_score
integer
trade_count
integer
category
string
created_at
string
resolved
boolean
won
boolean | null
profit_usdc
number | null
details
object