Skip to main content
GET
/
alerts
curl -H "Authorization: Bearer YOUR_KEY" \
  "https://polychadsbot.xyz/api/v1/alerts?category=crypto&min_signal=60&page=1"

{
  "alerts": [
    {
      "id": 2218,
      "alert_type": "fresh",
      "wallet_address": "0xcd5D...30D9",
      "event_title": "Opinion FDV above $500M?",
      "side": "BUY",
      "outcome": "Yes",
      "entry_price": 0.49,
      "usdc_value": 965.0,
      "signal_score": 65,
      "category": "crypto",
      "created_at": "2026-02-27 11:10:12"
    }
  ],
  "total": 581,
  "page": 1,
  "page_size": 50,
  "has_more": true
}
Search and filter the full alert history.
​
page
integer
default:"1"
Page number.
​
page_size
integer
default:"20"
Results per page. Max depends on tier (Free: 20, Pro: 50, Enterprise: 100).
​
category
string
Filter by category: crypto, politics, world, tech, finance, pop_culture, other.
​
side
string
BUY or SELL.
​
min_usdc
float
Minimum trade size in USDC.
​
min_signal
integer
Minimum signal score (0–100).
curl -H "Authorization: Bearer YOUR_KEY" \
  "https://polychadsbot.xyz/api/v1/alerts?category=crypto&min_signal=60&page=1"

{
  "alerts": [
    {
      "id": 2218,
      "alert_type": "fresh",
      "wallet_address": "0xcd5D...30D9",
      "event_title": "Opinion FDV above $500M?",
      "side": "BUY",
      "outcome": "Yes",
      "entry_price": 0.49,
      "usdc_value": 965.0,
      "signal_score": 65,
      "category": "crypto",
      "created_at": "2026-02-27 11:10:12"
    }
  ],
  "total": 581,
  "page": 1,
  "page_size": 50,
  "has_more": true
}

Authorizations

​
Authorization
string
header
required

Your API key — get one from @alrerat on Telegram

Query Parameters

​
page
integer
default:1

Page number

​
page_size
integer
default:20

Results per page

​
category
enum<string>

Filter by category

Available options:
crypto,
politics,
world,
tech,
finance,
pop_culture,
other
​
side
enum<string>

Filter by trade direction

Available options:
BUY,
SELL
​
min_usdc
number

Minimum trade size in USDC

​
min_signal
integer

Minimum signal score

Required range: 0 <= x <= 100

Response

200 - application/json

Paginated alerts

​
alerts
object[]
​
total
integer
​
page
integer
​
page_size
integer
​
has_more
boolean