Règles

Mettre en pause, reprendre ou renommer une règle

PATCH/v1/rules/{id}

La mise en pause d’une règle critique active est différée d’une heure (délai de sécurité) : la réponse est 202 avec pending_change, la règle continue de fonctionner d’ici là, et un propriétaire de l’espace peut annuler ou confirmer la demande depuis le tableau de bord. Les propriétaires et les canaux actifs sont prévenus. 409 change_already_pending si un changement attend déjà.

Authentification: Clé d’API (Authorization: Bearer)
Portée requise: write

Paramètres de chemin#

idstring · uuidobligatoire

Corps de la requête#

statestring
Valeurs active paused
namestring
de 1 à 120 caractères

Réponses#

200Règle modifiée.

Champs de l’objet

idstring · uuid
namestring
kindstring
Les règles créées par l’API sont de type large_transfer, new_counterparty ou burst ; les autres types se créent depuis le tableau de bord et sont renvoyés en lecture seule.

Valeurs large_transfer new_counterparty burst admin_change contract_upgrade low_balance balance_drop
chain_idstableau de integer
paramsobject
Paramètres normalisés de la règle (montants en unités brutes).
severitystring
Valeurs critical warning info
statestring
Valeurs active paused
immediate_alertbooleanpeut valoir null
Alerte avant les confirmations. null = valeur par défaut selon la gravité (oui pour critical).
channel_idstableau de string · uuid
pending_changeobjectpeut valoir null
Pause ou suppression différée d’une règle critique, effective à effective_at.
Champs de l’objet
- idstring · uuid
- actionstring
  Valeurs pause delete
- requested_atstring · date-time
- effective_atstring · date-time
created_atstring · date-time

202Pause d’une règle critique programmée dans une heure (voir pending_change).

Champs de l’objet

idstring · uuid
namestring
kindstring
Les règles créées par l’API sont de type large_transfer, new_counterparty ou burst ; les autres types se créent depuis le tableau de bord et sont renvoyés en lecture seule.

Valeurs large_transfer new_counterparty burst admin_change contract_upgrade low_balance balance_drop
chain_idstableau de integer
paramsobject
Paramètres normalisés de la règle (montants en unités brutes).
severitystring
Valeurs critical warning info
statestring
Valeurs active paused
immediate_alertbooleanpeut valoir null
Alerte avant les confirmations. null = valeur par défaut selon la gravité (oui pour critical).
channel_idstableau de string · uuid
pending_changeobjectpeut valoir null
Pause ou suppression différée d’une règle critique, effective à effective_at.
Champs de l’objet
- idstring · uuid
- actionstring
  Valeurs pause delete
- requested_atstring · date-time
- effective_atstring · date-time
created_atstring · date-time

4xx · 5xxErreur.

Erreur au format standard : voir Erreurs.

Requête

cURL

curl -X PATCH "https://aicscan.io/v1/rules/0193a1b4-2e7f-7a10-9b3c-4d5e6f708192" \
  -H "Authorization: Bearer $AICSCAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "state": "paused"
  }'

JavaScript

const res = await fetch('https://aicscan.io/v1/rules/0193a1b4-2e7f-7a10-9b3c-4d5e6f708192', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.AICSCAN_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "state": "paused"
  }),
});
const data = await res.json();
if (!res.ok) throw new Error(data.error.code);
console.log(data);

Python

import os
import requests

resp = requests.patch(
    "https://aicscan.io/v1/rules/0193a1b4-2e7f-7a10-9b3c-4d5e6f708192",
    headers={
        "Authorization": f"Bearer {os.environ['AICSCAN_API_KEY']}",
    },
    json={
        "state": "paused"
    },
    timeout=10,
)
resp.raise_for_status()
print(resp.json())

Réponse 200

JSON

{
  "id": "0193a1b4-2e7f-7a10-9b3c-4d5e6f708192",
  "name": "Treasury: large USDT outflows",
  "kind": "large_transfer",
  "chain_ids": [
    56
  ],
  "params": {
    "type": "large_transfer",
    "addresses": [
      "0x8894e0a0c962cb723c1976a4421c95949be2d4e3"
    ],
    "direction": "outgoing",
    "asset": {
      "kind": "token",
      "address": "0x55d398326f99059ff775485246999027b3197955"
    },
    "threshold": "0xa968163f0a57b400000"
  },
  "severity": "critical",
  "state": "active",
  "immediate_alert": null,
  "channel_ids": [
    "0193a1b3-7d21-7c55-8e0a-9f1b2c3d4e5f"
  ],
  "pending_change": null,
  "created_at": "2026-11-14T09:14:55.302Z"
}

Réponse 202

JSON

{
  "id": "0193a1b4-2e7f-7a10-9b3c-4d5e6f708192",
  "name": "Treasury: large USDT outflows",
  "kind": "large_transfer",
  "chain_ids": [
    56
  ],
  "params": {
    "type": "large_transfer",
    "addresses": [
      "0x8894e0a0c962cb723c1976a4421c95949be2d4e3"
    ],
    "direction": "outgoing",
    "asset": {
      "kind": "token",
      "address": "0x55d398326f99059ff775485246999027b3197955"
    },
    "threshold": "0xa968163f0a57b400000"
  },
  "severity": "critical",
  "state": "active",
  "immediate_alert": null,
  "channel_ids": [
    "0193a1b3-7d21-7c55-8e0a-9f1b2c3d4e5f"
  ],
  "pending_change": null,
  "created_at": "2026-11-14T09:14:55.302Z"
}