메인 콘텐츠로 건너뛰기

​
기본 URL

Sandbox:    https://api-sandbox.agentwallex.com/api/v1
Production: https://api.agentwallex.com/api/v1
개발 및 테스트에는 샌드박스 URL을 사용하세요. 실제 자금으로 거래할 준비가 된 경우에만 프로덕션으로 전환하세요.

​
인증

모든 API 요청에는 다음 인증 헤더 중 하나가 포함되어야 합니다:
방법헤더예시
API KeyX-API-KeyX-API-Key: awx_your_api_key
JWT BearerAuthorizationAuthorization: Bearer eyJhbGciOi...
# API key authentication
curl -X GET https://api.agentwallex.com/api/v1/agents \
  -H "X-API-Key: awx_your_api_key"

# JWT authentication
curl -X GET https://api.agentwallex.com/api/v1/agents \
  -H "Authorization: Bearer eyJhbGciOi..."
자격 증명 획득 및 관리에 대한 전체 세부 사항은 인증을 참조하세요.

​
페이지네이션

모든 목록 엔드포인트는 다음 쿼리 매개변수를 통해 페이지네이션을 지원합니다:
매개변수기본값최대설명
page_num1—페이지 번호 (1부터 시작)
page_size20100페이지당 항목 수
응답 형식: 
{
  "data": [],
  "total": 42,
  "has_more": true
}

​
오류 규약

모든 오류는 일관된 형식을 따릅니다: 
{
  "code": "invalid_request",
  "type": "invalid_request_error",
  "message": "human readable error description"
}

​
오류 유형

유형HTTP 상태설명
invalid_request_error400유효하지 않은 요청 본문 또는 매개변수
authentication_error401누락되었거나 유효하지 않은 자격 증명
authorization_error403권한 부족
not_found_error404리소스가 존재하지 않음
rate_limit_error429속도 제한 초과
internal_error500서버 측 오류
자세한 오류 처리 가이드는 오류 처리를 참조하세요.

​
API 섹션

에이전트

AI 에이전트 지갑을 생성하고 관리합니다.

거래

결제를 전송하고 거래 내역을 조회합니다.

정책

지출 한도 및 접근 제어를 구성합니다.

웹훅

웹훅 엔드포인트를 등록하고 관리합니다.

x402 결제

x402 소액 결제 협상을 실행합니다.

x402 세션

x402 세션 예산을 관리합니다.