Skip to main content
POST
/
webhooks
curl -X POST \
  -H "Authorization: Bearer YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-production-app.com/api/polychads-hook",
    "categories": "crypto,world",
    "min_signal": 80
  }' \
  https://polychadsbot.xyz/api/v1/webhooks

{
  "id": "hook_8812jka...",
  "url": "https://your-production-app.com/api/polychads-hook"
}
Webhooks are strictly for Enterprise infrastructure. If you’re running a massive deployment and need guaranteed HTTP delivery rather than maintaining WebSocket state, DM @alrerat to set up a massive custom limit.

​
How the Webhook System Works

You register a specific URL endpoint with us. The millisecond an alert passes your customized criteria, we blast a POST payload containing the complete alert JSON straight to your server. Your only job: Respond with a generic 200 OK status code within 5 seconds to tell us you received it. (Failed deliveries are not retried, to prevent backing up the queue).

​
Create a Webhook

Register your endpoint and tell us exactly what kind of alerts you want us to send. 
curl -X POST \
  -H "Authorization: Bearer YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-production-app.com/api/polychads-hook",
    "categories": "crypto,world",
    "min_signal": 80
  }' \
  https://polychadsbot.xyz/api/v1/webhooks

{
  "id": "hook_8812jka...",
  "url": "https://your-production-app.com/api/polychads-hook"
}

​
Configuration Fields

FieldRequiredDescription
urlYesYour secure HTTPS endpoint. We do not support unencrypted HTTP delivery.
categoriesNoComma-separated list of genres you care about. If omitted, we ping you for everything.
min_signalNoOnly send alerts with a Signal Score (0-100) equal to or above this number. Perfect for noise reduction.

​
The Payload Structure

When an alert fires, we will hit your url with a POST request. The body will be the standard Alert Object formatted as JSON:
What lands on your server
{
  "id": 2221,
  "alert_type": "fresh",
  "side": "BUY",
  "outcome": "Yes",
  "entry_price": 0.42,
  "usdc_value": 2100.0,
  "signal_score": 72,
  "event_title": "Will ETH hit $5000 by April?",
  "category": "crypto",
  "created_at": "2026-02-27 12:00:15"
}

​
Manage Existing Webhooks

​
List All Webhooks

See exactly what hooks are active on your current Enterprise key. 
curl -H "Authorization: Bearer YOUR_KEY_HERE" \
  https://polychadsbot.xyz/api/v1/webhooks

​
Delete a Webhook

Taking down a server? Clean up your hook so we stop hitting an empty endpoint. 
curl -X DELETE -H "Authorization: Bearer YOUR_KEY_HERE" \
  https://polychadsbot.xyz/api/v1/webhooks/{webhook_id}

Authorizations

​
Authorization
string
header
required

Your API key — get one from @chadsapibot on Telegram

Body

application/json
​
url
string
required

Your HTTPS endpoint

​
categories
string

Comma-separated categories to filter (e.g. "crypto,world")

​
min_signal
integer

Minimum signal score threshold

Required range: 0 <= x <= 100

Response

Created webhook

​
id
integer
​
url
string
​
categories
string | null
​
min_signal
integer | null
​
created_at
string