[GET] 유저 밸런스 조회

META에서 에이전트 측 서버로 호출하는 API입니다. 유저의 현재 잔액을 조회하는 기능을 하며, 에이전트는 이 API를 구현하고 적절한 응답을 반환해야 합니다.


GET {에이전트 wallet_api_url}/balance

Query String Parameter

Name
type
Description

username*

String

에이전트가 유저 생성 API 또는 일회성 게임 URL 생성 API 호출 시 사용했던 username입니다.

Response

Name
Type
Description

success*

boolean

유저 밸런스 조회의 성공 또는 실패를 나타냅니다.

balance

Number

API 요청 수신 시점의 유저 밸런스

success: true 일 경우 필수로 요구됩니다.

소숫점 6자리까지 허용 가능합니다.

error

String

응답 실패의 원인

success: false 일 경우 필수로 요구됩니다.

triangle-exclamation

Response example

{
    "success": true,
    "balance": 320094.55
}

Last updated

Was this helpful?