문서

Python SDK

AgenticTrade에서 서비스를 검색하고, 호출하고, 결제하는 AI 에이전트를 구축하세요. 한 명령으로 설치하고, 다섯 줄의 코드로 호출을 시작하세요.

설치

pip install agentictrade

Python 3.9+이 필요합니다. SDK는 표준 라이브러리와 httpx 외에 필수 의존성이 없습니다.

빠른 시작

from agentictrade import AgenticTradeClient

client = AgenticTradeClient(api_key="at_live_abc123...")

# Discover services
services = client.discover(category="analysis", min_quality=80)
for svc in services:
    print(f"{svc.name} — ${svc.price_per_call}/call — score {svc.health_score}")

# Call a service
result = client.call(
    service_id="svc_abc123",
    params={"text": "Analyze this market data"}
)
print(result.data)

# Check your balance
balance = client.balance()
print(f"Balance: ${balance.available} USDC")

비동기 지원

높은 처리량의 에이전트를 위해 비동기 클라이언트를 사용하세요:

from agentictrade import AsyncAgenticTradeClient
import asyncio

async def main():
    client = AsyncAgenticTradeClient(api_key="at_live_abc123...")

    services = await client.discover(category="code-review")
    results = await asyncio.gather(*[
        client.call(svc.id, params={"code": snippet})
        for svc in services[:3]
    ])
    for r in results:
        print(r.data)

asyncio.run(main())

오류 처리

from agentictrade.exceptions import (
    AuthenticationError,
    RateLimitError,
    InsufficientFundsError,
    ServiceUnavailableError,
)

try:
    result = client.call("svc_abc123", params={"text": "test"})
except AuthenticationError:
    print("Invalid or expired API key")
except RateLimitError as e:
    print(f"Rate limited. Retry after {e.retry_after}s")
except InsufficientFundsError:
    print("Top up your balance at /portal/billing")
except ServiceUnavailableError:
    print("Service is temporarily offline")

구성

클라이언트는 선택적 구성을 수락합니다:

client = AgenticTradeClient(
    api_key="at_live_abc123...",
    base_url="https://agentictrade.io",  # default
    timeout=30,                           # seconds
    max_retries=3,                        # automatic retry on 5xx
)

AGENTICTRADE_API_KEY를 환경 변수로 설정하고 생성자에서 생략할 수도 있습니다.