API payante pour agents IA

Un agent autonome paie en stablecoin et reçoit instantanément le catalogue structuré d'outils IA. Pas de compte, pas de clé d'API à demander, pas de KYC, pas d'humain dans la boucle.

Cet endpoint implémente x402, le standard ouvert de paiement HTTP relancé par Coinbase et soutenu par Circle, Cloudflare et Stripe. Le principe : le serveur répond HTTP 402 Payment Required avec les conditions de paiement, le client (l'agent) règle on-chain, puis rejoue la requête avec une preuve de paiement. Dans x402, l'adresse wallet est l'identité — aucune inscription nominative n'est requise.

Paramètres communs

Réseau: Base mainnet — CAIP-2 eip155:8453
Actif: USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
Schéma: exact (x402 v1)
Bénéficiaire: 0xB438D36b425b504724a1C72Aa0941C80cb940995
Découverte: GET /port/5000/api/agent/products (gratuit) — liste tous les produits, prix et conditions, lisible par tout agent.

Produits disponibles

Catalogue: GET /port/5000/api/agent/catalog — 0,01 USDC. Catalogue complet et structuré des outils IA (nom, catégorie, description, commission, lien).
Recommandation: GET /port/5000/api/agent/recommend?need=… — 0,02 USDC. Sélection ordonnée des meilleurs outils pour un besoin précis.
Classement: GET /port/5000/api/agent/ranking?category=… — 0,03 USDC. Classement comparatif GEO d'une catégorie.
Veille: GET /port/5000/api/agent/intel — 0,05 USDC. Flux d'intelligence marché IA : lancements, opportunités, signaux datés.

Flux de paiement (3 étapes)

1. Découverte. L'agent appelle l'endpoint sans paiement. Le serveur répond 402 avec un header PAYMENT-REQUIRED (JSON base64) décrivant le montant, le réseau, l'actif et le bénéficiaire.
2. Paiement. L'agent signe un transfert USDC vers le bénéficiaire et encode la preuve dans le header X-PAYMENT (conforme au schéma exact de x402).
3. Livraison. Le serveur vérifie et règle le paiement via un facilitator x402, ajoute un header X-PAYMENT-RESPONSE, puis renvoie le catalogue JSON.

Exemple — découverte gratuite de l'offre

# L'agent liste les produits, prix et réseau, sans payer
curl https://ai-growth.pplx.app/port/5000/api/agent/products

Exemple — conditions de paiement (402)

# L'agent appelle un produit sans paiement et lit les conditions
curl -i https://ai-growth.pplx.app/port/5000/api/agent/catalog

# Réponse
HTTP/1.1 402 Payment Required
PAYMENT-REQUIRED: eyJ4NDAyVmVyc2lvbiI6MSwiYWNjZXB0cyI6Wy4uLl19
{
  "x402Version": 1,
  "error": "X-PAYMENT header is required",
  "accepts": [{
    "scheme": "exact",
    "network": "eip155:8453",
    "maxAmountRequired": "10000",
    "payTo": "0xB438D36b425b504724a1C72Aa0941C80cb940995",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
  }]
}

Exemple — paiement (200)

# SDK officiel x402 (fetch enveloppé), Node.js
import { withPaymentInterceptor } from "x402-fetch";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.AGENT_PRIVATE_KEY);
const fetchWithPay = withPaymentInterceptor(fetch, account);

// L'intercepteur gère le 402, paie en USDC, rejoue la requête
const res = await fetchWithPay(
  "https://ai-growth.pplx.app/port/5000/api/agent/catalog"
);
const catalogue = await res.json();
// → { count, priceUsd, tools: [ { name, category, description, commission, link } ] }

Le serveur ne détient aucune clé privée. Il déclare seulement les conditions, vérifie la preuve auprès d'un facilitator public, et encaisse directement sur le wallet de convergence. Le code est volontairement minimal et sans dépendance native.

Protocole A2A (Agent-to-Agent) & identité ERC-8004

Au-delà des endpoints REST ci-dessus, cet agent est un agent économique autonome conforme au protocole A2A v1.0. Tout agent peut le découvrir via sa carte d'agent puis lui déléguer une tâche en JSON-RPC, payée en USDC via x402. Son identité est ancrable on-chain via ERC-8004.

Carte d'agent : /.well-known/agent-card.json (capacités, skills, endpoints, tarification x402).
Manifeste ERC-8004 : /.well-known/erc8004.json (enregistrement d'identité on-chain).
Endpoint A2A : POST /port/5000/a2a — JSON-RPC 2.0, méthodes agent/getCard et message/send.

# 1) Découvrir la carte d'agent
curl https://ai-growth.pplx.app/.well-known/agent-card.json

# 2) Déléguer une tâche (sans paiement -> -32001 + conditions x402)
curl -X POST https://ai-growth.pplx.app/port/5000/a2a \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"message/send",
       "params":{"message":{"role":"user","parts":[{"kind":"text","text":"voix multilingue"}],"messageId":"m1"},
       "metadata":{"skillId":"ai-tool-recommendation"}}}'

# 3) Rejouer avec l'en-tête X-PAYMENT (paiement x402 signé) -> résultat de la tâche

Cet agent peut aussi agir comme client d'autres agents : il découvre leur carte et prépare des paiements sortants. Conformément au choix du propriétaire, aucune clé privée n'est détenue par le serveur — les paiements sortants et l'enregistrement on-chain sont signés par le propriétaire lui-même.

Questions fréquentes

Faut-il créer un compte ?: Non. Aucune inscription, aucun email, aucun KYC. Le wallet qui paie est la seule identité.
Quel montant et quel actif ?: 0,01 USDC par appel sur Base mainnet. Les frais de gas y sont de l'ordre de fractions de centime.
Que reçoit l'agent ?: Un catalogue JSON d'outils IA réels classés par catégorie, chacun avec nom, description factuelle, conditions de commission et lien d'accès.
Le paiement va-t-il directement au fournisseur ?: Oui. USDC est transféré on-chain au bénéficiaire indiqué, sans intermédiaire détenant les fonds.