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