Webhooks

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

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

Field	Required	Description
`url`	Yes	Your secure HTTPS endpoint. We do not support unencrypted HTTP delivery.
`categories`	No	Comma-separated list of genres you care about. If omitted, we ping you for everything.
`min_signal`	No	Only 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

Response

Created webhook

integer

url

string

Getting Started

Real-Time

Reference

How the Webhook System Works

Create a Webhook

Configuration Fields

The Payload Structure

Manage Existing Webhooks

List All Webhooks

Delete a Webhook

Authorizations

Body

Response

​How the Webhook System Works

​Create a Webhook

​Configuration Fields

​The Payload Structure

​Manage Existing Webhooks

​List All Webhooks

​Delete a Webhook

Authorizations

Body

Response

How the Webhook System Works

Create a Webhook

Configuration Fields

The Payload Structure

Manage Existing Webhooks

List All Webhooks

Delete a Webhook