# Agent IA API

> API monétisée x402 pour agents IA : services IA (descriptions, résumés, extraction de données), utilitaires (IBAN, taux de change, unités, Keccak) et lectures blockchain sur Base et Ethereum (soldes, tokens, transactions, ENS, sanctions OFAC). Chaque appel est payé en USDC sur Base.

Toutes les routes sont en GET avec des paramètres dans l'URL (query string), sauf `/extraire-structure` qui est en POST avec un corps JSON. Sans paiement, chaque route payante répond `402 Payment Required` avec les instructions x402. Liste complète des routes : `/.well-known/x402`. Schéma détaillé : `/openapi.json`.

## Services IA

- [GET /description](https://api.api-agent-ia.ch/description): Génère 3 descriptions e-commerce pour un produit. Prix : $0.01. Paramètre : `product_name`. Réponse : `{"produit": "string", "descriptions": "string"}`.
- [GET /resume](https://api.api-agent-ia.ch/resume): Résume un texte en 5 lignes. Prix : $0.01. Paramètre : `text`. Réponse : `{"resume": "string"}`.
- [POST /extraire-structure](https://api.api-agent-ia.ch/extraire-structure): Extrait des données structurées d'un texte brut (fiche produit, email ou autre). Prix : $0.01. Corps : `{"text": "string"}` (max 8000 caractères). La réponse contient toujours `type`, et ses autres champs dépendent de ce type :
  - `produit` : `{"type": "produit", "nom", "prix", "caracteristiques"}`
  - `email` : `{"type": "email", "expediteur", "destinataires", "objet", "date", "resume", "actions"}`
  - `autre` : `{"type": "autre", "champs": {"clé": "valeur"}}`
  Les informations absentes du texte valent `null` ou une liste vide. En cas d'échec, l'API répond 502 et l'appel n'est pas facturé.

## Utilitaires

- [GET /valider-iban](https://api.api-agent-ia.ch/valider-iban): Vérifie la validité d'un IBAN. Prix : $0.005. Paramètre : `iban`. Réponse : `{"iban": "string", "valide": boolean, "pays": "string"}` (ou `"erreur"` si invalide).
- [GET /taux-de-change](https://api.api-agent-ia.ch/taux-de-change): Taux de référence BCE du jour entre deux devises (pas un cours de marché en direct). Prix : $0.002. Paramètres : `base`, `quote` (codes ISO, ex. CHF, EUR). Réponse : `{"base", "quote", "rate", "date", "source"}`.
- [GET /convertir-unites](https://api.api-agent-ia.ch/convertir-unites): Convertit entre wei, gwei et eth. Prix : $0.001. Paramètres : `valeur`, `unite_source`, `unite_cible`. Réponse : `{"valeur_entree", "unite_source", "valeur_sortie", "unite_cible"}`.
- [GET /hash-keccak](https://api.api-agent-ia.ch/hash-keccak): Hash Keccak-256 d'un texte. Prix : $0.001. Paramètre : `text`. Réponse : `{"text", "hash"}`.

## Lectures blockchain (Base)

- [GET /gaz](https://api.api-agent-ia.ch/gaz): Prix du gaz actuel. Prix : $0.001. Aucun paramètre. Réponse : `{"reseau", "bloc", "gas_price_gwei", "base_fee_gwei"}`.
- [GET /bloc](https://api.api-agent-ia.ch/bloc): Infos du dernier bloc ou d'un bloc précis. Prix : $0.001. Paramètre optionnel : `numero`. Réponse : `{"reseau", "bloc", "horodatage", "gas_utilise", "gas_limite", "transactions"}`.
- [GET /solde](https://api.api-agent-ia.ch/solde): Solde ETH d'une adresse. Prix : $0.002. Paramètre : `adresse`. Réponse : `{"adresse", "reseau", "eth"}`.
- [GET /solde-usdc](https://api.api-agent-ia.ch/solde-usdc): Solde USDC d'une adresse. Prix : $0.002. Paramètre : `adresse`. Réponse : `{"adresse", "reseau", "usdc"}`.
- [GET /nonce](https://api.api-agent-ia.ch/nonce): Nombre de transactions envoyées par une adresse. Prix : $0.002. Paramètre : `adresse`. Réponse : `{"adresse", "reseau", "nonce"}`.
- [GET /contrat](https://api.api-agent-ia.ch/contrat): Indique si une adresse est un contrat. Prix : $0.003. Paramètre : `adresse`. Réponse : `{"adresse", "reseau", "est_contrat", "taille_bytecode", "solde_eth", "nonce"}`.
- [GET /supply](https://api.api-agent-ia.ch/supply): Supply totale d'un token ERC-20. Prix : $0.002. Paramètre : `token` (adresse du contrat). Réponse : `{"token", "reseau", "symbole", "decimales", "supply"}`.
- [GET /info-token](https://api.api-agent-ia.ch/info-token): Nom, symbole, décimales et supply d'un token ERC-20. Prix : $0.003. Paramètre : `token`. Réponse : `{"token", "reseau", "nom", "symbole", "decimales", "supply"}`.
- [GET /allowance](https://api.api-agent-ia.ch/allowance): Montant qu'un spender peut dépenser pour un owner. Prix : $0.002. Paramètres : `token`, `owner`, `spender`. Réponse : `{"token", "owner", "spender", "allowance_brut", "allowance_formate", "illimitee", "symbol", "decimals", "reseau"}`.
- [GET /prix-token](https://api.api-agent-ia.ch/prix-token): Prix USD d'un token (source DefiLlama). Prix : $0.005. Paramètre : `token` (adresse, ou `eth` / `weth` / `usdc`). Réponse : `{"token", "reseau", "symbole", "prix_usd", "confiance", "horodatage", "source"}`.
- [GET /statut-tx](https://api.api-agent-ia.ch/statut-tx): Succès ou échec d'une transaction. Prix : $0.002. Paramètre : `hash`. Réponse : `{"hash", "statut", "bloc", "confirmations", "de", "vers", "gas_utilise"}`.
- [GET /tx](https://api.api-agent-ia.ch/tx): Détails d'une transaction. Prix : $0.005. Paramètre : `hash`. Réponse : `{"hash", "reseau", "de", "vers", "valeur_eth", "bloc", "nonce", "gas", "creation_contrat"}`.
- [GET /decode-tx](https://api.api-agent-ia.ch/decode-tx): Explique une transaction en une phrase, transferts de tokens inclus. Prix : $0.005. Paramètre : `hash`. Réponse : `{"hash", "explication", "statut", "de", "vers", "valeur_eth", "transferts_tokens", "nb_transferts_tokens"}`.

## ENS et conformité (Ethereum)

- [GET /resolution-nom](https://api.api-agent-ia.ch/resolution-nom): Nom ENS vers adresse. Prix : $0.002. Paramètre : `name` (ex. vitalik.eth). Réponse : `{"name", "reseau", "adresse"}`.
- [GET /nom-ens](https://api.api-agent-ia.ch/nom-ens): Adresse vers nom ENS principal. Prix : $0.002. Paramètre : `adresse`. Réponse : `{"adresse", "reseau", "name"}`.
- [GET /verifier-adresse-ofac](https://api.api-agent-ia.ch/verifier-adresse-ofac): Vérifie si une adresse EVM figure sur la liste de sanctions OFAC SDN (Trésor américain). Informatif uniquement, pas un avis juridique. Prix : $0.005. Paramètre : `adresse`. Réponse : `{"adresse", "sanctionnee", "correspondances", "liste", "date_liste", "donnees_telechargees_le", "avertissement"}`.

## Paiement

Protocole : x402. Réseau : Base Mainnet (`eip155:8453`). Asset : USDC. Facilitateur : CDP Coinbase.