파트너 크레딧 조회
현재 인증된 에이전트의 보유 Pots(알)를 실시간으로 조회합니다.
Pots 시스템 설명:
Pots: 에이전트가 보유한 가상 자산 단위
사용자 게임 및 입출금에 사용되는 에이전트의 핵심 자산
실시간으로 변동되며, 사용자 활동에 따라 증감
Pots 사용 용도:
사용자 입금: 사용자에게 Balance 지급 시 Pots에서 차감
사용자 출금: 사용자 Balance 회수 시 Pots로 증가
게임 운영: Seamless Wallet에서 게임 자금으로 사용
하위 에이전트: 하위 에이전트에게 Pots 분배 가능
실시간 반영:
트랜잭션 발생 시 즉시 업데이트
사용자 게임 승패에 따른 실시간 변동
입출금 처리 시 즉시 반영
정확성 보장:
데이터베이스 트리거를 통한 정확한 계산
동시성 제어로 데이터 무결성 보장
트랜잭션 로그를 통한 추적 가능
활용 시나리오:
대시보드 잔액 표시
입출금 가능 금액 확인
자산 현황 모니터링
정산 및 회계 처리
주의사항:
매우 빈번하게 변동될 수 있음
표시 시점과 실제 처리 시점의 차이 고려 필요
대용량 거래 시 잠시 지연될 수 있음
Authorizations
api-keystringRequired
에이전트별 발급된 API 키를 입력하세요
Responses
200
현재 보유 Pots 조회 성공
application/json
400
잘못된 요청 - 필수 헤더 누락
application/json
401
인증 실패 - 유효하지 않은 API 키 또는 에이전트 ID
application/json
404
에이전트를 찾을 수 없음
application/json
500
내부 서버 오류
application/json
get
/api/agents/my-potsLast updated