Adresses

Surveiller une adresse

POST/v1/addresses

Vérifie la limite de l’offre (plan_limit_reached). Une adresse déjà surveillée sur la même chaîne répond 409 address_already_watched, avec son id dans details.

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

Rejouable sans risque avec l’en-tête Idempotency-Key : voir Idempotence.

En-têtes#

Idempotency-Keystring
Permet de relancer le POST sans risque pendant 24 heures.

de 1 à 255 caractères

Corps de la requête#

chain_idintegerobligatoire
addressstringobligatoire
0x… (somme EIP-55 vérifiée en casse mixte) ou T… sur TRON.
labelstringpeut valoir null
au plus 80 caractères

Réponses#

201Créée.

En-têtes de réponse

Locationstring
URL de la nouvelle adresse.
Idempotent-Replayedstring
true quand la réponse est le rejeu d’une requête précédente de même Idempotency-Key.

Valeurs true

Champs de l’objet

idstring · uuid
chain_idinteger
addressstring
Hexadécimal en minuscules.

^0x[0-9a-f]{40}$
display_addressstring
Forme avec somme de contrôle EIP-55 (base58 sur TRON).
labelstringpeut valoir null
created_atstring · date-time

4xx · 5xxErreur.

Erreur au format standard : voir Erreurs.

Requête

cURL

curl -X POST "https://aicscan.io/v1/addresses" \
  -H "Authorization: Bearer $AICSCAN_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "chain_id": 56,
    "address": "0x8894E0a0c962CB723c1976a4421c95949bE2D4E3",
    "label": "Treasury"
  }'

JavaScript

const res = await fetch('https://aicscan.io/v1/addresses', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.AICSCAN_API_KEY}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': crypto.randomUUID(),
  },
  body: JSON.stringify({
    "chain_id": 56,
    "address": "0x8894E0a0c962CB723c1976a4421c95949bE2D4E3",
    "label": "Treasury"
  }),
});
const data = await res.json();
if (!res.ok) throw new Error(data.error.code);
console.log(data);

Python

import os, uuid
import requests

resp = requests.post(
    "https://aicscan.io/v1/addresses",
    headers={
        "Authorization": f"Bearer {os.environ['AICSCAN_API_KEY']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "chain_id": 56,
        "address": "0x8894E0a0c962CB723c1976a4421c95949bE2D4E3",
        "label": "Treasury"
    },
    timeout=10,
)
resp.raise_for_status()
print(resp.json())

Réponse 201

JSON

{
  "id": "0193a1b2-5c3d-7e4f-8a9b-0c1d2e3f4a5b",
  "chain_id": 56,
  "address": "0x8894e0a0c962cb723c1976a4421c95949be2d4e3",
  "display_address": "0x8894E0a0c962CB723c1976a4421c95949bE2D4E3",
  "label": "Treasury",
  "created_at": "2026-11-14T09:10:03.774Z"
}