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 Webhook経由で残高が自動的にクレジットされます。

リクエストボディ

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

イベント通知を受信する新しいWebhookエンドポイントを登録します。

リクエストボディ

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

アカウントに登録されたすべてのWebhookを一覧表示します。

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

Webhookサブスクリプションを削除します。

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