사용자 자산 조정

사용자 잔액 조정

post

사용자 계정의 잔액을 임의로 조정합니다.

중요 제한사항:

• Seamless wallet은 이 기능을 지원하지 않습니다

• Transfer wallet만 사용 가능

처리 방식:

• 양수: 잔액 증가 (에이전트 팟에서 차감)

• 음수: 잔액 감소 (에이전트 팟으로 이동)

사용 시나리오:

• 시스템 오류 보정

• 특별 이벤트 적용

• 관리 목적의 잔액 조정

주의사항: 이 기능은 관리 목적으로만 사용해야 하며, 일반적인 입출금에는 credit/debit 엔드포인트를 사용하세요.

권한 요구사항:

• API Key 헤더 필수

• Agent ID 헤더 필수

• Transfer wallet 타입만 지원

Authorizations

ApiKeyAuthAgentIdAuth

api-keystringRequired

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

Body

application/json

usernamestringRequired

잔액 조정할 사용자명

Example: user123

amountnumberRequired

조정 금액 (양수: 증가, 음수: 감소)

Example: -1000

Responses

200

잔액 조정 성공

application/json

201Success

application/json

400

잘못된 요청 또는 지원하지 않는 지갑 타입

application/json

401

인증 실패

application/json

404

사용자를 찾을 수 없음

application/json

500

서버 내부 오류

application/json

post

/api/transfer/adjust

HTTPcURLJavaScriptPython

POST /api/transfer/adjust HTTP/1.1
Host: {HIGHEND-API-SERVER}
api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 38

{
  "username": "user123",
  "amount": 1000.5
}

잔액 증가잔액 감소오류 보정

{
  "balance": 16000.5
}