API-Dokumentation

Gibt alle registrierten Dienste mit Preisinformationen zurück. Keine Authentifizierung erforderlich.

Abfrageparameter

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

Erweiterte Entdeckung mit Filterung, Sortierung und Tag-Abgleich.

Abfrageparameter

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

Gibt verfügbare Dienstkategorien mit Dienstanzahl zurück.

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

Gibt Gesamtaufrufe, Ausgaben und durchschnittliche Latenz für den authentifizierten Käufer zurück.

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}

Erstellt eine Krypto-Zahlungsrechnung über NOWPayments. Unterstützt USDT, USDC, BTC, ETH und 300+ Kryptowährungen.

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..."}

Nach Zahlungsbestätigung wird Ihr Guthaben automatisch über den IPN-Webhook gutgeschrieben.

Request Body

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.

Gibt Dienstanzahl, Gesamtaufrufe, Umsatz und Abrechnungsstatus für den authentifizierten Anbieter zurück.

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

Gibt alle Dienste des authentifizierten Anbieters mit Nutzungsstatistiken zurück.

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

Detaillierte Analysen für einen bestimmten Dienst: Gesamtaufrufe, Umsatz, Erfolgsquote, tägliche Aufschlüsselung.

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

Gibt Gesamteinnahmen, abgerechnete und ausstehende Beträge sowie Abrechnungshistorie zurück.

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

Gibt Gesundheitsbewertungen für alle Ihre Dienste basierend auf Latenz, Fehlerquote und Verfügbarkeit zurück.

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

Testet die Konnektivität zu Ihrem Dienst-Endpunkt. Gibt Erreichbarkeit, Latenz und Statuscode zurück.

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

Verfolgen Sie Ihren Onboarding-Fortschritt: API-Schlüssel-Erstellung, Dienstregistrierung, erster Traffic, erste Abrechnung.

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

Erstellt eine neue Abrechnung für einen Anbieter. Erfordert Admin-Rolle.

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

Listet alle Abrechnungen auf, optional gefiltert nach Anbieter oder Status.

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

Markiert eine Abrechnung als bezahlt und löst die On-Chain-Überweisung aus.

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

Generiert einen eindeutigen Empfehlungscode für den authentifizierten Benutzer.

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

Löst einen Empfehlungscode bei der Registrierung ein, um Konten zu verknüpfen.

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

Listet alle Empfehlungen des authentifizierten Benutzers auf.

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

Aggregierte Empfehlungsstatistiken: Gesamtempfehlungen, Konversionsrate und Einnahmen.

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

Registriert einen neuen Webhook-Endpunkt für Ereignisbenachrichtigungen.

Request Body

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

Listet alle registrierten Webhooks Ihres Kontos auf.

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

Entfernt ein Webhook-Abonnement.

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

Gibt das Sicherheits-Audit-Protokoll mit Filteroptionen zurück.

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

Aggregierte Audit-Statistiken: Ereignisanzahl nach Typ und Zeitraum.

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