Documentation API

Retourne tous les services enregistrés avec les informations tarifaires. Aucune authentification requise.

Paramètres de requête

curl https://agentictrade.io/api/v1/services?category=crypto-analysis

Découverte enrichie avec filtrage, tri et correspondance de tags.

Paramètres de requête

curl "https://agentictrade.io/api/v1/discover?tags=crypto&max_price=1.0&sort=price"

Retourne les catégories disponibles avec le nombre de services.

curl https://agentictrade.io/api/v1/discover/categories

Retourne le nombre total d'appels, les dépenses et la latence moyenne pour l'acheteur authentifié.

curl -H "Authorization: Bearer {key_id}:{secret}" \
  https://agentictrade.io/api/v1/usage/me

# {"buyer_id": "my-agent", "total_calls": 42, "total_spent_usd": "12.50", "avg_latency_ms": 35}

curl https://agentictrade.io/api/v1/balance/my-agent-001

# {"buyer_id": "my-agent-001", "balance": 50.0, "total_deposited": 100.0, "total_spent": 50.0}

Crée une facture de paiement crypto via NOWPayments. Supporte USDT, USDC, BTC, ETH et plus de 300 cryptomonnaies.

curl -X POST https://agentictrade.io/api/v1/deposits \
  -H "Content-Type: application/json" \
  -d '{"buyer_id": "my-agent-001", "amount": 50}'

# {"deposit_id": "...", "amount": 50, "status": "pending",
#  "checkout_url": "https://nowpayments.io/payment/?iid=...",
#  "message": "Pay $50 at the checkout URL..."}

Après confirmation du paiement, votre solde est automatiquement crédité via le webhook IPN.

Corps de la requête

curl -X POST https://agentictrade.io/api/v1/keys \
  -H "Content-Type: application/json" \
  -d '{"owner_id": "my-trading-bot", "role": "buyer"}'

# {"key_id": "acf_...", "secret": "...", "role": "buyer", "rate_limit": 60}
# IMPORTANT: Save the secret! It cannot be retrieved later.

Retourne le nombre de services, le total des appels, les revenus et le statut de règlement pour le fournisseur authentifié.

curl -H "Authorization: Bearer {key_id}:{secret}" \
  https://agentictrade.io/api/v1/provider/dashboard

Retourne tous les services appartenant au fournisseur authentifié avec les statistiques d'utilisation.

curl -H "Authorization: Bearer {key_id}:{secret}" \
  https://agentictrade.io/api/v1/provider/services

Analyses détaillées d'un service spécifique : total des appels, revenus, taux de réussite, ventilation quotidienne.

curl -H "Authorization: Bearer {key_id}:{secret}" \
  https://agentictrade.io/api/v1/provider/services/{service_id}/analytics

Retourne le total gagné, réglé, en attente et l'historique des règlements.

curl -H "Authorization: Bearer {key_id}:{secret}" \
  https://agentictrade.io/api/v1/provider/earnings

Retourne les scores de santé de tous vos services basés sur la latence, le taux d'erreur et la disponibilité.

curl -H "Authorization: Bearer {key_id}:{secret}" \
  https://agentictrade.io/api/v1/provider/health

Teste la connectivité vers votre endpoint de service. Retourne l'accessibilité, la latence et le code de statut.

curl -X POST -H "Authorization: Bearer {key_id}:{secret}" \
  https://agentictrade.io/api/v1/provider/services/{service_id}/test

Suivez votre progression d'intégration : création de clé API, enregistrement de service, premier trafic, premier règlement.

curl -H "Authorization: Bearer {key_id}:{secret}" \
  https://agentictrade.io/api/v1/provider/onboarding

Crée un nouveau règlement pour un fournisseur. Nécessite le rôle administrateur.

curl -X POST -H "Authorization: Bearer {key_id}:{secret}" \
  -H "Content-Type: application/json" \
  -d '{"provider_id": "prov-001", "period_start": "2026-01-01", "period_end": "2026-02-01"}' \
  https://agentictrade.io/api/v1/settlements

Liste tous les règlements, avec filtrage optionnel par fournisseur ou statut.

curl -H "Authorization: Bearer {key_id}:{secret}" \
  https://agentictrade.io/api/v1/settlements

Marque un règlement comme payé et déclenche le transfert on-chain.

curl -X PATCH -H "Authorization: Bearer {key_id}:{secret}" \
  https://agentictrade.io/api/v1/settlements/{settlement_id}/pay

Génère un code de parrainage unique pour l'utilisateur authentifié.

curl -X POST -H "Authorization: Bearer {key_id}:{secret}" \
  https://agentictrade.io/api/v1/referrals/code

Applique un code de parrainage lors de l'inscription pour lier les comptes.

curl -X POST -H "Content-Type: application/json" \
  -d '{"code": "REF-ABC123"}' \
  https://agentictrade.io/api/v1/referrals/apply

Liste tous les parrainages effectués par l'utilisateur authentifié.

curl -H "Authorization: Bearer {key_id}:{secret}" \
  https://agentictrade.io/api/v1/referrals

Statistiques agrégées de parrainage : total des parrainages, taux de conversion et revenus.

curl -H "Authorization: Bearer {key_id}:{secret}" \
  https://agentictrade.io/api/v1/referrals/stats

Enregistre un nouvel endpoint webhook pour recevoir les notifications d'événements.

Corps de la requête

curl -X POST -H "Authorization: Bearer {key_id}:{secret}" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://myapp.com/webhooks", "events": ["usage.created"]}' \
  https://agentictrade.io/api/v1/webhooks

Liste tous les webhooks enregistrés pour votre compte.

curl -H "Authorization: Bearer {key_id}:{secret}" \
  https://agentictrade.io/api/v1/webhooks

Supprime un abonnement webhook.

curl -X DELETE -H "Authorization: Bearer {key_id}:{secret}" \
  https://agentictrade.io/api/v1/webhooks/{webhook_id}

Retourne le journal d'audit de sécurité avec des options de filtrage.

curl -H "Authorization: Bearer {key_id}:{secret}" \
  https://agentictrade.io/api/v1/admin/audit

Statistiques d'audit agrégées : nombre d'événements par type et par période.

curl -H "Authorization: Bearer {key_id}:{secret}" \
  https://agentictrade.io/api/v1/admin/audit/summary