ChangeFinancialInformation

Used to update and increase Investment Experience, Investment Objectives, and/or Financial Information for existing accounts. The service cannot be used to downgrade experience.

Request Parameters

XSD

Copy

<xsd:complexType name="ChangeFinancialInformation">
<xsd:sequence>
 <xsd:element name=" NewFinancialInformation" type="FinancialInformation" maxOccurs="1" />
</xsd:sequence>
<xsd:sequence>
 <xsd:attribute name="reference_account_id" type="xsd:string" use="required">
</xsd:sequence>
 <xsd:attribute name="knowledge_level" type="xsd:knowledge_level_type" use="required">
 <xsd:attribute name="years_trading" type="xsd:nonNegativeInteger" use="required">
 <xsd:attribute name="trades_per_year" type="xsd:nonNegativeInteger" use="required">
 <xsd:attribute name="asset_class" type="xsd:asset_class_type" use="required">
</xsd:sequence>
<xsd:sequence>
 <xsd:attribute name="annual_net_income" type="xsd:nonNegativeInteger" use="required">
 <xsd:attribute name="net_worth" type="xsd:nonNegativeInteger" use="required">
 <xsd:attribute name="liquid_net_worth" type="xsd:nonNegativeInteger" use="required">
</xsd:sequence>

Attributes

Name	Type	Description
reference_account_id	String	IBKR account ID of the advisor/broker client account documents are being requested for.
knowledge_level	Limited Good Extensive	Knowledge level the account holder has of the specified asset_class.
years_trading	nonNegativeInteger	Number of years the account holder has trading this specific asset_class.
trades_per_year	nonNegativeInteger	Number of trades per year placed by the account holder.
asset_class	STK BOND OPT FUT	Asset class which investment experience is being provided for
annual_net_income	nonNegativeInteger OR	The total amount of your earnings for one year minus any taxes or other deductions taken from your pay. These other deductions could include health insurance, retirement contributions, court ordered judgements or support payments. For financials, you can include Absolute or Interval ranges. Financial_Ranges.xls attached for Interval values.
net_worth	nonNegativeInteger OR	The total value of all assets you own, less what you owe (including all mortgages and debts). Your Net Worth cannot be less than your Liquid Net Worth. For financials, you can include Absolute or Interval ranges. Financial_Ranges.xls attached for Interval values.
liquid_net_worth	nonNegativeInteger OR	The total value of any assets you own that can be quickly converted into cash. For financials, you can include Absolute or Interval ranges. Financial_Ranges.xls attached for Interval values.

Sample

Copy

Update Investment Experience for Options

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AcctMgmtRequests xmlns="http://www.interactivebrokers.com/schemas/IBCust_import">
   <ChangeFinancialInformation reference_account_id="U000008">
      <NewFinancialInformation>
         <InvestmentExperience>
         <AssetExperience knowledge_level="Good" years_trading="2" asset_class="OPT" trades_per_year="5"/>
         </InvestmentExperience>
      </NewFinancialInformation>
   </ChangeFinancialInformation>
</AcctMgmtRequests>

Copy

Update Financial Information (using range_id)

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AcctMgmtRequests xmlns="http://www.interactivebrokers.com/schemas/IBCust_import">
  <ChangeFinancialInformation reference_account_id="U000009">
    <NewFinancialInformation>
      <InvestmentExperience>
        <AssetExperience asset_class="STK" knowledge_level="Extensive" trades_per_year="50" years_trading="20"/>
      </InvestmentExperience>
      <InvestmentObjectives>
        <objective>Trading</objective>
        <objective>Speculation</objective>
      </InvestmentObjectives>
    </NewFinancialInformation>
  </ChangeFinancialInformation>
</AcctMgmtRequests>

Response Parameters

Name	Type	Description
Execution_Date	YYYY/MM/DD HH:MM:SS	Date/Time which the file was processed by IBKR.
Process_File	FirmName_YYYY-MM-DD_######.xml	File name of the request file.
Client	FirmName	Name of the Counterparty
Client_Master_Acct	String	Master account number
ChangeFinancialInformation	String	Status of the request
reference_account_id	String	IBKR account ID of the advisor/broker client account which the request is being submitted for
request_status	PROCESSED ERROR PENDING	Status of the request
message	String	Status of the request.
request_id	Non-negative integer	Unique ID which IBKR assigns to the request. The ID can be used to query status request at a later time using //getAmRequestStatus endpoint
message	String	Includes details on the status of the request IF status=”PENDING" or "PROCESSED "
Pending_Tasks	<Tasks>	Includes pending tasks associated with the info change request IF status=”PENDING"
Errors	String	Includes error message if status=”ERROR”

Sample

Copy

Success

<?xml version='1.0' encoding='UTF-8'?>
<Process>
  <Execution ECA_XML_Schema_Version="15-Nov-2018">
    <Execution_Date>2020/02/20 00:44:38</Execution_Date>
    <Process_File>TesterFA_2020-02-20_124438885_761126.xml</Process_File>
    <Client>TesterFA</Client>
    <Client_Master_Acct>F1234567</Client_Master_Acct>
  </Execution>
   <ChangeFinancialInformation reference_account_id="U2088007" request_status="PROCESSED" message="Status of the request" request_id="50813"/>
</Process>

Copy

Error

<?xml version='1.0' encoding='UTF-8'?>
<Process>
  <Execution ECA_XML_Schema_Version="15-Nov-2018">
    <Execution_Date>2020/02/20 00:44:38</Execution_Date>
    <Process_File>TesterFA_2020-02-20_124438885_761126.xml</Process_File>
    <Client>TesterFA</Client>
    <Client_Master_Acct>F1234567</Client_Master_Acct>
  </Execution>
   <ChangeFinancialInformation reference_account_id="U2088007" request_status="ERROR" request_id="50813">
    <Error>Error Message Here</Error>
  </ChangeFinancialInformation>
</Process>