Документация API

Возвращает все зарегистрированные сервисы с информацией о ценах. Аутентификация не требуется.

Параметры запроса

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

Расширенное обнаружение с фильтрацией, сортировкой и сопоставлением тегов.

Параметры запроса

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

Возвращает доступные категории сервисов с количеством сервисов.

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

Возвращает общее количество вызовов, расходы и среднюю задержку для аутентифицированного покупателя.

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}

Создаёт криптовалютный платёжный счёт через NOWPayments. Поддерживает USDT, USDC, BTC, ETH и 300+ криптовалют.

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

После подтверждения платежа ваш баланс автоматически пополняется через IPN-вебхук.

Тело запроса

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.

Возвращает количество сервисов, общее число вызовов, доход и статус расчётов для аутентифицированного провайдера.

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

Возвращает все сервисы аутентифицированного провайдера со статистикой использования.

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

Детальная аналитика по конкретному сервису: общее число вызовов, доход, процент успеха, разбивка по дням.

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

Возвращает общий доход, выплаченные и ожидающие суммы, а также историю расчётов.

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

Возвращает оценки здоровья всех ваших сервисов на основе задержки, частоты ошибок и доступности.

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

Тестирует подключение к эндпоинту вашего сервиса. Возвращает доступность, задержку и код статуса.

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

Отслеживайте прогресс подключения: создание API-ключа, регистрация сервиса, первый трафик, первый расчёт.

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

Создаёт новый расчёт для провайдера. Требуется роль администратора.

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

Выводит список всех расчётов с возможностью фильтрации по провайдеру или статусу.

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

Помечает расчёт как оплаченный и инициирует перевод в блокчейне.

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

Генерирует уникальный реферальный код для аутентифицированного пользователя.

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

Применяет реферальный код при регистрации для связывания аккаунтов.

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

Выводит список всех рефералов аутентифицированного пользователя.

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

Агрегированная статистика рефералов: общее число рефералов, конверсия и доходы.

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

Регистрирует новый эндпоинт вебхука для получения уведомлений о событиях.

Тело запроса

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

Выводит список всех зарегистрированных вебхуков вашего аккаунта.

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

Удаляет подписку на вебхук.

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

Возвращает журнал аудита безопасности с опциями фильтрации.

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

Агрегированная статистика аудита: количество событий по типу и временному периоду.

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