본문으로 건너뛰기

외부 지갑 또는 별도 비트멕스 계정으로 인출 요청.

POST 
/api/v1/user/requestWithdrawal

이메일 확인​

대부분의 경우 이 엔드포인트는 기록된 이메일 주소로 확인 이메일을 발송합니다. 저장된 주소(예: addressId 또는 해당 address)로 인출하는 경우 skipConfirm이 설정되어 있으면 인출이 즉시 확인됩니다.

이중인증​

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

내부 전송​

유효한 비트멕스 입금 주소가 제공되면 거래는 비트멕스 계정 간 직접 이루어지며, 체인 상 거래가 생성되지 않고 네트워크 수수료도 부과되지 않습니다. 다른 계정 ID(targetUserId)가 지정된 경우, 해당 계정이 인증된 계정과 연결된 경우에만 요청이 성공합니다.

이점을 참고하세요 /api/v1/user/walletTransfer가 연결된 계정 간 전송에 더 적합할 수 있습니다.

저장 주소 검증​

저장된 주소를 사용할 때 skip2FA 및 skipConfirm은 다음을 통해 검증되어야 합니다:

  • skip2FA는 주소를 생성할 때 otpToken을 제공하여 검증할 수 있습니다. 만약 otpToken이 제공되지 않았다면 주소 생성 시 발송된 이메일의 링크를 통해 이중인증 코드를 제공할 수 있습니다.

  • skipConfirm은 주소 생성 시 발송된 이메일의 링크를 통해 검증할 수 있습니다.

화이트리스트​

주소록에 whitelist 설정이 활성화되어 있다면 모든 인출 요청은 저장된 주소 또는 연결된 계정으로 이루어져야 합니다. 다른 주소는 거부됩니다. 저장된 주소는 활성 상태여야 합니다. 새로 저장된 주소는 이중인증 검증을 완료하고 주소 생성 이후 쿨다운 기간이 지났을 때 활성 상태가 됩니다.

요청​

응답​

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