Alertes

Lister les alertes (correspondances des règles)

GET/v1/matches

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

Liste paginée par curseur : voir Pagination.

Paramètres de requête#

chain_idinteger · int64
Identifiant de chaîne : 56 BNB Chain, 1 Ethereum, 8453 Base, 42161 Arbitrum One, 137 Polygon, 728126428 TRON.
rule_idstring · uuid
severitystring
Valeurs critical warning info
sincestring
Date ou date-heure ISO 8601, incluse (par exemple 2026-11-01T00:00:00Z).
untilstring
Date ou date-heure ISO 8601, exclue.
limitinteger
Par défaut 50
de 1 à 100
cursorstring
next_cursor de la page précédente, tel quel.

Réponses#

200Une page d’alertes.

Champs de l’objet

datatableau de objectobligatoire
Champs de chaque élément
- idstring · uuid
- phasestring
  immediate = vue avant les confirmations.
  
  Valeurs immediate confirmed
- created_atstring · date-time
- ruleobject
  Champs de l’objet
  - idstring · uuid
  - namestring
  - severitystring
    Valeurs critical warning info
- eventobject
  Champs de l’objet
  - idstring · uuid
  - chain_idinteger
  - block_numberinteger
  - block_hashstring
  - block_timestampstring · date-timepeut valoir null
  - tx_hashstring
  - sourcestring
    balance : événement issu d’une lecture de solde (règles de solde).
    
    Valeurs log tx trace balance
  - source_indexinteger
  - typestring
    Par exemple erc20_transfer, native_transfer.
  - contractstringpeut valoir null
  - fromstringpeut valoir null
  - tostringpeut valoir null
  - tokenstringpeut valoir null
  - amountstringpeut valoir null
    Montant entier brut (plus petite unité), sous forme de chaîne.
  - statusstring
    Valeurs pending confirmed orphaned
  - payloadobject
  - created_atstring · date-time
- acknowledgedobjectpeut valoir null
  Champs de l’objet
  - bystring
  - atstring · date-time
has_morebooleanobligatoire
next_cursorstringobligatoirepeut valoir null

4xx · 5xxErreur.

Erreur au format standard : voir Erreurs.

Requête

cURL

curl "https://aicscan.io/v1/matches?chain_id=56&severity=critical&limit=20" \
  -H "Authorization: Bearer $AICSCAN_API_KEY"

JavaScript

const res = await fetch('https://aicscan.io/v1/matches?chain_id=56&severity=critical&limit=20', {
  headers: {
    Authorization: `Bearer ${process.env.AICSCAN_API_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(data.error.code);
console.log(data);

Python

import os
import requests

resp = requests.get(
    "https://aicscan.io/v1/matches?chain_id=56&severity=critical&limit=20",
    headers={
        "Authorization": f"Bearer {os.environ['AICSCAN_API_KEY']}",
    },
    timeout=10,
)
resp.raise_for_status()
print(resp.json())

Réponse 200

JSON

{
  "data": [
    {
      "id": "0193a1c9-3f10-7d42-8a1b-2c3d4e5f6a7b",
      "phase": "confirmed",
      "created_at": "2026-11-14T09:30:13.590Z",
      "rule": {
        "id": "0193a1b4-2e7f-7a10-9b3c-4d5e6f708192",
        "name": "Treasury: large USDT outflows",
        "severity": "critical"
      },
      "event": {
        "id": "0193a1c9-3e02-7f3a-9b4c-5d6e7f8091a2",
        "chain_id": 56,
        "block_number": 45123456,
        "block_hash": "0x5f1c0a7e9d3b2c4a6e8f0d1b3c5a7e9f1d3b5c7a9e1f3d5b7c9a1e3f5d7b9c1a",
        "block_timestamp": "2026-11-14T09:30:12Z",
        "tx_hash": "0x9a8b7c6d5e4f30211203f4e5d6c7b8a99a8b7c6d5e4f30211203f4e5d6c7b8a9",
        "source": "log",
        "source_index": 211,
        "type": "erc20_transfer",
        "contract": "0x55d398326f99059ff775485246999027b3197955",
        "from": "0x8894e0a0c962cb723c1976a4421c95949be2d4e3",
        "to": "0x77cd0000000000000000000000000000000001e2",
        "token": "0x55d398326f99059ff775485246999027b3197955",
        "amount": "250000000000000000000000",
        "status": "confirmed",
        "payload": {},
        "created_at": "2026-11-14T09:30:13.402Z"
      },
      "acknowledged": null
    }
  ],
  "has_more": true,
  "next_cursor": "0193a1b25c3d7e4f8a9b0c1d2e3f4a5b"
}