AI 에이전트가 x402 + AgenticTrade로 API 비용을 자동 결제하게 하는 방법

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

1. 에이전트가 MCP(Model Context Protocol)를 통해 서비스를 발견
       ↓
2. 에이전트가 AgenticTrade에서 선불 잔액을 확인
       ↓
3. 에이전트가 x402 결제 헤더와 함께 요청을 전송
       ↓
4. AGENTICTRADE PROXY가 요청을 가로채 자금을 확인하고, 차감한 뒤, 전달
       ↓
5. 서비스가 실행되고 결과를 반환
       ↓
6. AGENTICTRADE가 사용량을 기록하고, 평판을 업데이트하고, 제공자에게 정산

1

pip install agentictrade-python

1
2
3
4
5
6
7

from agentictrade import AgenticTradeClient

# 에이전트의 API key로 초기화 (agentictrade.io/dashboard에서 발급)
client = AgenticTradeClient(
    api_key="acp_your_agent_proxy_key",  # Buyer proxy key
    agent_id="agent_abc123"               # 등록된 에이전트 ID
)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

# 에이전트가 필요한 서비스를 검색
services = client.discover(
    category="data",
    tags=["crypto", "sentiment", "nlp"],
    max_price=0.05,  # 호출당 최대 가격 (USD)
    min_reputation=0.8  # 평판 점수 80% 이상만
)

print(f"Found {len(services)} matching services:")
for svc in services:
    print(f"  - {svc.name}: ${svc.price_per_call}/call (reputation: {svc.reputation})")

# 최적의 서비스 선택
selected = services[0]
print(f"Using: {selected.name}")

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

# 핵심: 결제가 proxy 계층에서 자동으로 처리됩니다
# 에이전트는 돈을 다루지 않습니다 — 메서드만 호출하면 됩니다

result = client.call(
    service_id=selected.id,
    endpoint="/sentiment",
    params={"symbol": "BTC", "timeframe": "24h"}
)

# 이게 전부입니다. x402 헤더가 주입되고, 자금이 확인되고,
# 호출이 프록시되고, 결과를 받습니다.

print(f"Sentiment score for BTC: {result.sentiment_score}")
print(f"Confidence: {result.confidence}")
print(f"Cost: ${result.metadata.amount_charged} (deducted automatically)")

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

# 에이전트의 선불 잔액 확인
balance = client.get_balance()
print(f"Balance: ${balance.available} USDC")
print(f"Pending: ${balance.pending}")

# 필요시 충전 (NOWPayments 암호화폐 결제)
if balance.available < 1.00:
    checkout_url = client.create_topup_url(amount=50, currency="USDC")
    print(f"Top up at: {checkout_url}")
    # 프로덕션에서는: 에이전트가 이를 모니터링하고 잔액이 낮으면 자동 충전

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49

from agentictrade import AgenticTradeClient

client = AgenticTradeClient(api_key="acp_your_agent_key")

def agent_task(task_description: str):
    """
    에이전트가 필요한 것을 판단하고, 적합한 서비스를 발견하고,
    비용을 결제합니다 — 모두 자율적으로.
    """

    # Step 1: 작업에 필요한 도구 파싱
    required_capabilities = parse_capabilities(task_description)
    # 예: ["sentiment_analysis", "price_data", "news_scraping"]

    results = {}

    for capability in required_capabilities:
        # Step 2: 해당 기능에 최적인 서비스를 자동 검색
        services = client.discover(
            capability=capability,
            max_price=0.10,
            min_reputation=0.7
        )

        if not services:
            print(f"⚠️ No service found for: {capability}")
            continue

        # Step 3: 평판 최고 + 비용 최저 옵션 선택
        best = min(services, key=lambda s: (-s.reputation, s.price_per_call))

        # Step 4: 실행 — x402를 통해 결제가 자동 처리
        result = client.call(best.id, params=build_params(task_description, capability))

        # Step 5: 감사를 위한 거래 기록
        client.log_transaction(
            service_id=best.id,
            capability=capability,
            cost=result.metadata.amount_charged,
            quality_score=result.metadata.latency_ms
        )

        results[capability] = result.data

    return results

# 사용 예시
task = "Analyze Bitcoin sentiment from social media and cross-reference with BTC price data"
outputs = agent_task(task)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20

1. 수신: POST /api/v1/proxy/{service_id}/sentiment
   Headers:
     Authorization: Bearer acp_your_key
     Content-Type: application/json
     X-Payment-Auth-Type: x402
     X-Payment-Max-Amount: 0.05  (지불 의사가 있는 최대 금액)

2. 선불 잔액이 $0.05 초과인지 확인

3. 서비스 제공자의 실제 endpoint로 요청 전달

4. 응답 수신 시: 최종 금액을 계산하고, 잔액에서 차감하고,
   제공자 계정에 입금하고, 사용 메타데이터를 기록

5. 반환: 데이터 + 빌링 헤더:
   X-ACF-Amount: 0.012
   X-ACF-Currency: USDC
   X-ACF-Provider: svc_4a8f2c1d9e3b
   X-ACF-Latency-Ms: 34
   X-ACF-Rate-Limit-Remaining: 287

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22

# 에이전트의 거래 내역 조회
transactions = client.get_transactions(
    limit=100,
    service_id="svc_4a8f2c1d9e3b"  # 선택적 필터
)

for tx in transactions:
    print(f"{tx.timestamp}: {tx.endpoint} → ${tx.amount} ({tx.latency_ms}ms)")

# 서비스별 지출 집계
spending = client.get_spending_report(period="30d")
print(spending)
# {
#   "total_spent": 847.32,
#   "by_service": {
#     "Crypto Sentiment API": 423.50,
#     "CoinSifter Scanner": 321.12,
#     "Strategy Backtest": 102.70
#   },
#   "avg_cost_per_call": 0.0087,
#   "total_calls": 97422
# }

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

from agentictrade import Team

team = Team(team_id="trading_team_01")

# 어떤 서브 에이전트가 어떤 서비스를 호출할 수 있는지 정의
team.add_member(
    agent_id="sentiment_agent",
    allowed_services=["sentiment_api", "news_api"],
    max_budget_per_day=5.00
)

team.add_member(
    agent_id="execution_agent",
    allowed_services=["price_api", "order_api"],
    max_budget_per_day=50.00
)

# 품질 게이트 설정 — 서비스 안정성이 80% 미만이면 자동으로 백업으로 라우팅
team.add_quality_gate(
    primary_service="price_api",
    backup_service="price_api_v2",
    min_reliability=0.80
)

# 팀 리더가 통합 지출 확인
report = team.get_spending_report()
print(f"Team total: ${report.total_spent} ({report.total_calls} calls)")

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

# 1. SDK 설치
pip install agentictrade-python

# 2. agentictrade.io에서 가입하고 buyer proxy key 발급

# 3. 자금 입금 (NOWPayments로 암호화폐 결제 또는 Base의 USDC)
#    신규 계정에는 $5 무료 크레딧 제공

# 4. 예제 실행
python -m agentictrade.examples.autopay_demo

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# 15줄 전체 예제
from agentictrade import AgenticTradeClient
client = AgenticTradeClient(api_key="acp_your_key")

# 검색
services = client.discover(tags=["crypto", "sentiment"], max_price=0.01)
best = services[0]

# 자동 결제 및 호출
result = client.call(best.id, params={"symbol": "ETH"})
print(result.data)