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

列出你帳戶中所有已註冊的 Webhooks。

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