Aicscan Documentation

Statut du service

Page d’état#

La page publique aicscan.io/statut montre, sans connexion :

  • l’état de lecture de chaque chaîne (à jour ou en retard, secondes depuis le dernier bloc) ;
  • les contrôles croisés des 7 derniers jours : événements vérifiés auprès d’une source indépendante et événements manqués ;
  • le délai entre le bloc et l’envoi des alertes sur 7 jours (médiane et 95e centile) ;
  • le résultat de l’alerte témoin envoyée régulièrement de bout en bout sur 30 jours ;
  • les incidents des 30 derniers jours.

GET /v1/health#

Pour une supervision automatique, utilisez GET /v1/health. Il est public (aucune clé), ne compte dans aucun quota et ne renvoie aucune donnée client.

Shell
curl https://aicscan.io/v1/health
JSON
{
  "at": "2026-11-14T09:31:02.551Z",
  "chains": [
    { "chain_id": 56, "name": "BNB Chain", "up": true, "last_processed_block": 45123470, "last_confirmed_block": 45123455, "seconds_since_block": 1.2 },
    { "chain_id": 728126428, "name": "TRON", "up": true, "last_processed_block": 77104412, "last_confirmed_block": 77104393, "seconds_since_block": 2.8 }
  ],
  "status": "ok",
  "api_version": "1"
}
Champ Sens
status ok quand l’API répond.
chains[].up Le lecteur de la chaîne est actif.
chains[].last_processed_block Dernier bloc lu.
chains[].last_confirmed_block Dernier bloc confirmé.
chains[].seconds_since_block Secondes depuis la dernière avancée de la lecture.

Une valeur seconds_since_block élevée (plusieurs minutes) signale un retard de lecture : les alertes de cette chaîne arriveront en retard, sans être perdues. Après une interruption, le lecteur rattrape les blocs manqués et chaque alerte en retard le signale dans son texte.

En cas d’incident#

  • Les espaces sont prévenus sur leurs canaux par un message type: "service" lors d’une interruption et de la reprise.
  • Pendant une interruption de l’API, les alertes continuent d’être produites et envoyées sur vos canaux ; vos appels peuvent recevoir 5xx : relancez avec un délai croissant et la même Idempotency-Key.
  • Après une coupure du flux temps réel, reconnectez-vous avec last_id : les alertes manquées sont rejouées (7 jours).

Aicscan ne vous demandera jamais de vous connecter à un wallet, de signer une transaction ni d’envoyer des fonds.

aicscan.io · Statut · openapi.yaml