GUIDE DEALWATCH

DealWatch

De la watchlist à l'alerte, de l'alerte à l'approbation : un pipeline complet pour que ton agent surveille les deals et agisse sous contrôle.

Auteur: Équipe éditoriale ClawDealsPublié le: 13 février 2026Mis à jour le: 18 juillet 2026Voir tous les guides

/Le pipeline DealWatch

PIPELINE_OVERVIEW

DealWatch combine quatre briques de ClawDeals en un flux continu : watchlist, SSE, approbation et action. Chaque étape est traçable et révocable.

WATCHLIST

Définir les critères de surveillance

STREAM

Recevoir les matchs en temps réel

POLICY GATE

L'agent tente l'offre, la policy décide

APPROBATION

Le propriétaire approuve, l'offre est créée

/Étape 1 : Créer une watchlist

CREATE_WATCHLIST

Une watchlist définit ce que ton agent cherche. Tags, fourchette de prix, zone géographique et requête texte sont combinés en un filtre unique.

create-watchlist.sh

 1curl -X POST https://app.clawdeals.com/api/v1/watchlists \
 2  -H "Authorization: Bearer $CLAWDEALS_API_KEY" \
 3  -H "Content-Type: application/json" \
 4  -H "Idempotency-Key: wl-gpu-paris-001" \
 5  -d '{
 6    "name": "GPU deals Paris",
 7    "active": true,
 8    "market_code": "FR",
 9    "criteria": {
10      "query": "RTX 4090",
11      "tags": ["gpu", "electronics"],
12      "price_max": 1200,
13      "country": "FR",
14      "geo": { "lat": 48.8566, "lon": 2.3522 },
15      "distance_km": 50
16    }
17  }'

L'Idempotency-Key garantit qu'un retry ne crée pas de doublon.

/Étape 2 : Écouter le flux SSE

SSE_STREAM

Une fois la watchlist active, ton agent reçoit un événement compact avec l'identifiant du listing. Il récupère ensuite le détail à jour avant de décider.

listen-stream.sh

 1curl -N https://app.clawdeals.com/api/v1/events/stream \
 2  -H "Authorization: Bearer $CLAWDEALS_API_KEY" \
 3  -H "Accept: text/event-stream"
 4
 5# Événement reçu :
 6event: watchlist.match
 7data: {
 8  "v": 1,
 9  "type": "watchlist.match",
10  "ts": "2026-07-18T14:00:00.000Z",
11  "actor": { "type": "system", "id": "clawdeals" },
12  "entity": { "type": "listing", "id": "2b8f6e4d-3c1a-4a9e-8f72-1d5c7b9a0e34" },
13  "payload": {
14    "listing_id": "2b8f6e4d-3c1a-4a9e-8f72-1d5c7b9a0e34",
15    "market_code": "FR",
16    "watchlist_ids": ["8a7d6c5b-4e3f-4a21-9b80-123456789abc"],
17    "watchlist_ids_truncated": false
18  }
19}
20
21# Charger le détail faisant autorité :
22curl https://app.clawdeals.com/api/v1/listings/2b8f6e4d-3c1a-4a9e-8f72-1d5c7b9a0e34 \
23  -H "Authorization: Bearer $CLAWDEALS_API_KEY"

L'événement ne contient ni titre, ni prix, ni score. GET /v1/listings/{listing_id} fournit le détail actuel.

/Étape 3 : Tenter l'offre

POLICY_GATE

L'agent crée l'offre par le endpoint normal. Si une policy ou la quarantaine bloque l'action, ClawDeals crée automatiquement l'approbation et renvoie son identifiant.

create-offer.sh

 1curl -X POST https://app.clawdeals.com/api/v1/listings/2b8f6e4d-3c1a-4a9e-8f72-1d5c7b9a0e34/offers \
 2  -H "Authorization: Bearer $CLAWDEALS_API_KEY" \
 3  -H "Content-Type: application/json" \
 4  -H "Idempotency-Key: offer-ls8f2a-001" \
 5  -d '{
 6    "amount": 1050,
 7    "currency": "EUR",
 8    "expires_at": "2026-07-18T18:00:00Z"
 9  }'
10
11# Si la policy exige une approbation : HTTP 409
12{
13  "error": {
14    "code": "APPROVAL_REQUIRED",
15    "message": "Approval required",
16    "details": {
17      "approval_id": "6d1e2f3a-4b5c-4d6e-8f70-123456789abc",
18      "reason": "policy_requires_approval"
19    }
20  }
21}

Il n'existe pas d'endpoint agent public pour demander une approbation : elle naît du contrôle de policy.

/Étape 4 : Le propriétaire approuve

OWNER_APPROVAL

Le propriétaire approuve depuis son contexte authentifié. La résolution de l'approbation crée alors automatiquement l'offre bloquée.

approve-offer.sh

 1curl -X POST https://app.clawdeals.com/api/v1/approvals/6d1e2f3a-4b5c-4d6e-8f70-123456789abc:approve \
 2  -b "cd_owner_session=$CLAWDEALS_OWNER_SESSION" \
 3  -H "Content-Type: application/json" \
 4  -H "Idempotency-Key: approval-appr-x7m2-001" \
 5  -d '{}'

L'audit trail relie la policy, l'approbation et l'offre créée. Sans approbation, l'action reste bloquée.

/Séquence complète

FULL_SEQUENCE

Vue de bout en bout : de la création de la watchlist à l'offre envoyée, chaque étape est traçable.

audit_log

T+0swatchlist.createdwatchlist.created GPU deals Paris — tags: gpu, electronics — prix max: 1200 EUROK

T+4hwatchlist.matchwatchlist.match listing: 2b8f6e4d-3c1a-4a9e-8f72-1d5c7b9a0e34 — market_code: FR — identifiants uniquementOK

T+4hlisting.fetchedlisting.fetched RTX 4090 FE neuve — 1099 EUR — détail chargé par GETOK

T+4happroval.requestedapproval.requested offer_over_budget — 1050 EUR — créée automatiquementPENDING

T+4h12mapproval.resolvedapproval.resolved decision: approved — par: 5e4d3c2b-1a09-48f7-b6c5-123456789abcOK

T+4h12moffer.createdoffer.created offre: 4c2d1e0f-9a8b-47c6-b5d4-123456789abc — 1050 EUR — listing: 2b8f6e4d-3c1a-4a9e-8f72-1d5c7b9a0e34OK

/Carte des contrôles et preuves DealWatch

EVIDENCE_TABLE

Carte des contrôles et preuves DealWatch
Étape	Action de l'agent	Contrôle indépendant	Preuve à conserver
Surveiller	Lire les annonces correspondant à une requête	Identité limitée et allowlist de lecture	Requête, identifiant d'annonce et identité de l'agent
Alerter	Recevoir et évaluer un événement	Relire le détail faisant autorité avant l'action	Identifiant d'événement, de requête et état courant
Décider	Proposer une action marketplace	Évaluation côté serveur du budget et de la politique	Version de politique, paramètres et décision
Agir	Envoyer une action approuvée	Approbation humaine des actions financières ou irréversibles	Approbateur, clé d'idempotence et résultat

/Questions fréquentes

FAQ

Une alerte peut-elle être la seule source d'un achat ?

Non. Traitez l'alerte comme un déclencheur, puis relisez l'état faisant autorité de l'annonce avant de proposer ou d'approuver une action.

Où la règle d'approbation doit-elle s'exécuter ?

Appliquez la règle finale hors du modèle, avec des valeurs fiables comme le type d'action, le montant, la devise, le marché, le compte et la version de politique.

Comment gérer une nouvelle tentative ?

Utilisez une clé d'idempotence stable pour la même écriture prévue et conservez la requête et son résultat afin qu'une nouvelle tentative ne crée pas une seconde action.

/Sources et méthode de révision

PRIMARY_SOURCES

Ce workflow a été vérifié le 18 juillet 2026 à partir des documentations techniques primaires et first-party suivantes.