Documentation de l’API Aicscan
Aicscan surveille en continu les adresses de votre trésorerie, de votre projet ou de vos clients sur plusieurs chaînes, et vous alerte dès qu’un mouvement correspond à l’une de vos règles. Cette documentation s’adresse aux développeurs qui veulent piloter Aicscan depuis leur code et recevoir les alertes dans leurs propres systèmes.
Trois façons d’intégrer Aicscan#
| Outil | Usage | Page |
|---|---|---|
| API REST v1 | Gérer les adresses, règles et canaux ; lire les alertes, événements et notifications. | Référence de l’API |
| Webhooks signés | Recevoir chaque alerte en POST JSON sur votre serveur, signée en HMAC-SHA256. |
Webhooks |
| Temps réel | Recevoir les alertes en direct sur une connexion WebSocket, avec reprise après coupure. | Temps réel |
Les alertes peuvent aussi partir vers Telegram, helloMe, Discord, Slack ou par email : voir Canaux.
L’essentiel en un coup d’œil#
- URL de base :
https://aicscan.io/v1 - Format : JSON en UTF-8, dates ISO 8601 en UTC, montants en entiers bruts sous forme de chaîne.
- Authentification :
Authorization: Bearer aic_…, une clé par espace, portéesreadetwrite. Voir Authentification. - Offres : l’API est comprise dans les offres Pro et Business. Voir Offres et quotas.
- Erreurs : toujours
{ "error": { "code", "message", "details" } }, avec uncodestable. Voir Erreurs. - Version : la version majeure est dans le chemin (
/v1) et dans l’en-têteAicscan-Api-Version. Voir Versionnement.
curl https://aicscan.io/v1/health{
"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 }
],
"status": "ok",
"api_version": "1"
}Par où commencer#
- Créez une clé d’API dans votre espace client (page Clés d’API), puis suivez le démarrage rapide : de la clé à la première alerte reçue, en une dizaine de minutes.
- Lisez les types de règles pour choisir ce que vous voulez surveiller.
- Branchez un webhook et vérifiez ses signatures.
Le document OpenAPI 3.1 complet est téléchargeable sur /v1/openapi.yaml : importez-le dans Postman, Insomnia ou un générateur de client.
Contact#
Une question sur l’API, une offre Business ou un problème d’intégration : écrivez à support@aicscan.io. Indiquez le nom de votre espace et, pour une erreur, la route appelée, l’heure (UTC) et le code reçu ; n’envoyez jamais une clé d’API complète.
Sécurité
Aicscan ne vous demandera jamais de vous connecter à un wallet, de signer une transaction ni d’envoyer des fonds. Aucun message d’alerte ne contient de lien hors du domaine aicscan.io.