| name | sapphire-webhook |
| description | TradingView webhook receiver — validates and routes signals to alpha engine |
| type | service |
| runtime | python |
| deploy_target | windows-pc |
| dependencies | ["sapphire-core"] |
| entry_point | src/receiver.py |
| test_command | pytest tests/ |
services/webhook
Lightweight FastAPI service that receives TradingView alerts and routes them to the alpha engine. Validates webhook secrets, normalizes signal format, and publishes a type:trading event.
Signal Schema
{
"symbol": "ETHUSD",
"action": "buy" | "sell" | "close",
"strategy": "v3_ultra" | "multi_screener",
"price": 3200.50,
"confidence": 0.87
}
Security
- Webhook secret validated in payload body (
secret field must match WEBHOOK_SECRET env var)
- No GCP Secret Manager — secret set in local
.env on Windows PC
Deploy (on-prem — Windows PC)
Signal routing: TradingView → Cloudflare Tunnel → Windows PC:9090 → rari1:18081 + rari2:18081 (Tailscale)
# Set env vars in C:\sapphire\.env
# WEBHOOK_SECRET, ALPHA_ENGINE_RARI1, ALPHA_ENGINE_RARI2, OLLAMA_URL
cd C:\sapphire\webhook
python -m uvicorn src.receiver:app --host 0.0.0.0 --port 9090
# TradingView alert URL: https://webhook.sapphirealpha.xyz/webhook/tradingview
Cloudflare Tunnel
See infra/cloudflare/SETUP.md for public HTTPS ingress setup.
