본문으로 건너뛰기

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

POST 
/user/requestWithdrawal

이메일 확인​

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

이중인증(2FA)​

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

내부 이체​

유효한 비트멕스 입금 주소가 제공되면, 거래는 비트멕스 계정 간에 직접 이루어집니다. 온체인 트랜잭션이 발생하지 않으며 네트워크 수수료도 부과되지 않습니다.

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

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

저장된 주소 검증​

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

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

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

화이트리스트​

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

요청​

응답​

요청이 성공적으로 처리되었습니다.