API publique — SCC

Référence des endpoints REST. Authentification via JWT Bearer (header Authorization: Bearer <token>). Specs OpenAPI complètes : /api/openapi.json · Swagger UI : /api/docs

Value bets

GET/value-bets

Liste des value bets actifs filtrables.

curl -H "Authorization: Bearer $TOKEN" \
  "$API/value-bets?min_ev=0.03&sport=football&limit=20"

GET/value-bets/event/{event_id}

Value bets pour un match.

curl -H "Authorization: Bearer $TOKEN" \
  "$API/value-bets/event/abc"

Surebets

GET/surebets

Surbets actifs multi-bookies.

curl -H "Authorization: Bearer $TOKEN" "$API/surebets"

Predictions

GET/predictions/event/{event_id}
Toutes les prédictions modèle pour un event.
```
curl -H "Authorization: Bearer $TOKEN" "$API/predictions/event/abc"
```
GET/predictions/event/{event_id}/explain
SHAP-like explainability Dixon-Coles.
```
curl "$API/predictions/event/abc/explain"
```
GET/predictions/event/{event_id}/ah
Asian Handicap analyse 25 lignes + EV vs marché.
```
curl "$API/predictions/event/abc/ah"
```

Community

GET/community/profiles/{handle}
Profil public.
```
curl "$API/community/profiles/jeanfr"
```
GET/leaderboard?window=30d
Leaderboard ROI 30 jours.
```
curl "$API/leaderboard?window=30d"
```

Webhooks

POST/me/webhooks

Enregistrer un webhook (HTTPS + HMAC SHA-256).

curl -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"target_url": "https://my.bot/wh", "event_types": ["value_bet.new"]}' \
  $API/me/webhooks

Combo

POST/combo/analyze

Analyse combiné (EV + Kelly stake).

curl -H "Authorization: Bearer $TOKEN" -d '{"legs":[...]}' $API/combo/analyze

Tax

GET/me/tax/3916?year=2026

Brouillon Form 3916 (comptes étrangers).

curl -H "Authorization: Bearer $TOKEN" "$API/me/tax/3916?year=2026"

GET/me/tax/2086?year=2026&as_csv=true

Brouillon Form 2086 plus-values (CSV download).

curl -H "Authorization: Bearer $TOKEN" -o form_2086.csv \
  "$API/me/tax/2086?year=2026&as_csv=true"

Limites & rate-limits

1000 requêtes / heure / token utilisateur
30 requêtes / minute en burst
Webhooks : retry exponentiel, max 5 tentatives
OG images cachées 5-10 min côté CDN