sapphire-webhook
TradingView webhook receiver — validates and routes signals to alpha engine
Source facts
- Repository
- arigatoexpress/Sapphire
- Last source activity
- July 18, 2026 at 03:02
- Detected SKILL.md language
- English
- Stars
- 1
- Forks
- 0
Install options
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Review the source files
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
File Explorer
5 filesShowing SKILL.md
SKILL.md
Source instructions · Read-only preview- 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
```json
{
"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)
```powershell
# 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.
View on GitHub