본문으로 건너뛰기

외부 지갑 또는 별도의 비트멕스 계정으로의 출금을 요청합니다.

POST 
/api/v1/user/requestWithdrawal

이메일 확인​

대부분의 경우, 이 엔드포인트는 등록된 이메일 주소로 확인 이메일을 보냅니다. 저장된 주소(즉, addressId 또는 해당하는 address 를 제공)로 skipConfirm 이 설정된 경우, 출금은 즉시 확인됩니다.

이중인증​

모든 출금에는 유효한 2FA 코드(otpToken)가 필요합니다. 단, 목적지 주소가 skip2FA 가 설정된 저장된 주소이거나 연결된 비트멕스 계정(예: 서브계정)인 경우는 예외입니다.

내부 이체​

유효한 비트멕스 입금 주소가 제공되면, 트랜잭션은 비트멕스 계정 간에 직접 처리됩니다. 온체인 트랜잭션이 생성되지 않으며 네트워크 수수료도 부과되지 않습니다.

다른 계정 ID(targetUserId)가 지정된 경우, 해당 계정이 인증된 계정에 연결된 경우에만 요청이 성공합니다.

연결된 계정 간 이체에는 /api/v1/user/walletTransfer 엔드포인트를 사용하는 것이 더 적합할 수 있습니다.

저장된 주소 검증​

저장된 주소를 사용할 때 skip2FA 및 skipConfirm 에는 검증이 필요합니다:

  • skip2FA 는 주소를 생성할 때 otpToken 을 제공하여 검증할 수 있습니다. otpToken 이 제공되지 않은 경우, 주소 생성 시 발송된 이메일에 포함된 링크를 방문하여 2FA 코드를 입력할 수 있습니다.

  • skipConfirm 은 주소 생성 시 발송된 이메일에 포함된 링크를 방문하여 검증할 수 있습니다.

화이트리스트​

주소록에 whitelist 설정이 활성화된 경우, 모든 출금 요청은 저장된 주소 또는 연결된 계정으로만 보내야 합니다. 그 외의 모든 주소는 거부됩니다. 또한 저장된 주소는 활성 상태여야 합니다. 새로 저장된 주소는 2FA 검증을 완료하고 생성 후 쿨다운 기간이 경과해야 활성 상태가 됩니다.

요청​

응답​

요청이 성공했습니다