New Real-Money Account: Default Landing Company (new_account_real)¶

This call opens a new real-money account. This call can be made from a virtual-money or a real-money account. If it is the latter, client information fields in this call will be ignored and data from your existing real-money account will be used.

Auth Scope(s): admin

new_account_real(account_opening_reason: Optional[str] = None, account_turnover: Optional[str] = None, address_city: Optional[str] = None, address_line_1: Optional[str] = None, address_line_2: Optional[str] = None, address_postcode: Optional[str] = None, address_state: Optional[str] = None, affiliate_token: Optional[str] = None, citizen: Optional[str] = None, client_type: Optional[str] = None, currency: Optional[str] = None, date_of_birth: Optional[str] = None, first_name: Optional[str] = None, last_name: Optional[str] = None, non_pep_declaration: Optional[int] = None, phone: Optional[str] = None, place_of_birth: Optional[str] = None, residence: Optional[str] = None, salutation: Optional[str] = None, secret_answer: Optional[str] = None, secret_question: Optional[str] = None, tax_identification_number: Optional[str] = None, tax_residence: Optional[str] = None, passthrough: Optional[Any] = None, req_id: Optional[int] = None) → int¶

Parameters:	account_opening_reason (Optional[str]) – [Optional] Purpose and reason for requesting the account opening. account_turnover (Optional[str]) – [Optional] The anticipated account turnover. address_city (Optional[str]) – [Optional] Within 100 characters. address_line_1 (Optional[str]) – Within 70 characters, with no leading whitespaces and may contain letters/numbers and/or any of following characters ‘.,:;()@#/- address_line_2 (Optional[str]) – [Optional] Within 70 characters. address_postcode (Optional[str]) – [Optional] Within 20 characters and may not contain ‘+’. address_state (Optional[str]) – [Optional] Possible value receive from states_list call. affiliate_token (Optional[str]) – [Optional] Affiliate token, within 32 characters. citizen (Optional[str]) – [Optional] Country of legal citizenship, 2-letter country code. client_type (Optional[str]) – [Optional] Indicates whether this is for a client requesting an account with professional status. currency (Optional[str]) – [Optional] To set currency of the account. List of supported currencies can be acquired with payout_currencies call. date_of_birth (Optional[str]) – Date of birth format: yyyy-mm-dd. first_name (Optional[str]) – Within 2-50 characters, use only letters, spaces, hyphens, full-stops or apostrophes. last_name (Optional[str]) – Within 2-50 characters, use only letters, spaces, hyphens, full-stops or apostrophes. non_pep_declaration (Optional[int]) – [Optional] Indicates client’s self-declaration of not being a PEP/RCA (Politically Exposed Person/Relatives and Close Associates). phone (Optional[str]) – [Optional] Starting with + followed by 9-35 digits, hyphens or space. place_of_birth (Optional[str]) – [Optional] Place of birth, 2-letter country code. residence (Optional[str]) – 2-letter country code, possible value receive from residence_list call. salutation (Optional[str]) – [Optional] Accept any value in enum list. secret_answer (Optional[str]) – [Optional] Answer to secret question, within 4-50 characters. Required for new account and existing client details will be used if client open another account. secret_question (Optional[str]) – [Optional] Accept any value in enum list. Required for new account and existing client details will be used if client open another account. tax_identification_number (Optional[str]) – [Optional] Tax identification number. Only applicable for real money account. Required for maltainvest landing company. tax_residence (Optional[str]) – [Optional] Residence for tax purpose. Comma separated iso country code if multiple jurisdictions. Only applicable for real money account. Required for maltainvest landing company. passthrough (Optional[Any]) – [Optional] Used to pass data through the websocket, which may be retrieved via the echo_req output field. req_id (Optional[int]) – [Optional] Used to map request to response.
Returns:	req_id
Return type:	int

Example¶

binary.api.new_account_real(
    account_opening_reason='Speculative'
    account_turnover='Less than $25,000'
    address_city='Melbourne'
    address_line_1='20 Broadway Av'
    address_line_2='East Melbourne VIC'
    address_postcode='3002'
    address_state='Victoria'
    date_of_birth='1980-01-31'
    first_name='Peter'
    last_name='Pan'
    non_pep_declaration=1
    phone='+6123456789'
    place_of_birth='id'
    residence='au'
    salutation='Mr'
    secret_answer='Jones'
    secret_question="Mother's maiden name"
    tax_identification_number='012142545'
    tax_residence='ar,sg'
)