사용자 자산 조회

사용자 잔액 조회

get

특정 사용자의 현재 잔액을 조회합니다.

주요 기능:

• 실시간 잔액 조회

• 에이전트별 사용자 격리 (본인 소속 사용자만)

• 정확한 소수점 처리

사용 시나리오:

• 사용자 잔액 확인

• 거래 전 잔액 검증

• 대시보드 잔액 표시

제한사항:

• 사용자가 존재하지 않으면 404 오류

• 에이전트별로 격리된 사용자 데이터만 조회 가능

권한 요구사항:

• API Key 헤더 필수

• Agent ID 헤더 필수

Authorizations

ApiKeyAuthAgentIdAuth

api-keystringRequired

에이전트별 발급된 API 키를 입력하세요

Query parameters

usernamestringRequired

조회할 사용자명 (필수)

Example: 바람의나라

Responses

200

잔액 조회 성공

application/json

400

잘못된 요청 파라미터

application/json

401

인증 실패

application/json

404

사용자를 찾을 수 없음

application/json

500

서버 내부 오류

application/json

get

/api/transfer/balance

HTTPcURLJavaScriptPython

GET /api/transfer/balance?username=바람의나라 HTTP/1.1
Host: {HIGHEND-API-SERVER}
api-key: YOUR_API_KEY
Accept: */*

{
  "balance": 15000
}