int_position_transfer

https://[domain]/ws/fb/new-request

  • Used to internally transfer positions between two IBKR Accounts based on eligibility.

  • Customer Type: Fully Disclosed, Non-Disclosed, and Advisor-Clients.

  • Non-Disclosed Clients:

    • Internally transfer positions between Non-Disclosed Master and Non-Disclosed Sub.

  • Fully-Disclosed and Advisor Clients:

    • The Account Titles of both accounts must match.

    • The country of legal residence of both accounts must - match.

    • For US customers, the US tax ID (Social Security number) of both accounts must match.

    • For non-US Individual customers, the ID number, ID type (passport, driver's license, national ID, or alien ID) and ID-issuing country must match. For joint non-US customers, the IDs of both first and second holder must match.

    • Customers with linked accounts can use this type of transfer. However, customers with multiple accounts that are eligible to be linked but are not currently linked cannot use this type of transfer

  • Requests submitted during regular trading hours of the exchange which the product is traded on will transfer immediately. Requests submitted outside of regular trading hours will be processed the next business day.

Name Type Description

Name

Type

Description

source_ib_acct

String

Account which positions are being sent from.

destination_ib_acct

String

Account which positions are being sent to.

con_id

String

Unique Contract ID assigned by Interactive Brokers.

 

position

Integer

Size of the position

transfer_quantity

Integer

Number of shares being transferred.

currency

USD

HUF

EUR

CZK

GBP

CNH

CAD

DKK

JPY

RUB

HKD

ILS

AUD

NOK

CHF

SGD

MXN

PLN

SEK

ZAR

NZD

 

 

Currency of the assets being transferred. 

id

ID is a unique identifier which you create for each funding request.

  • ID cannot be reused

  • ID must be established in sequential order ie 1, 2, 3, 4  or 100, 101, 102, 103 not 777, 589, 123

  • Max 10 digits for file ID

  • Max 20 digits for counterparty transaction ID

security_id

String

CUSIP/ISIN number of the security being transferred.

asset_type

BILL

BOND

CASH

FUND

OPT

STK

WAR

Product type. 

security_id_type

CUSIP

ISIN

Used to determine security_id type that was provided. Either ISIN or CUSIP.

contract_desc

String

Symbol or description of security.

There are 2 options for submitting int_position_transfer request:

XSD

Copy 
<xsd:complexType name="int_position_transfer" maxOccurs="unbounded" >
<xsd:attribute name="id" type="Non-Negative-Integer" maxOccurs="1" />
<xsd:sequence>
 <xsd:element name="source_ib_acct" type="string" use=”Required” maxOccurs="1" />
 <xsd:element name="destination_ib_acct" type="string" use=”Required”  maxOccurs="1" />
 <xsd:element name="security_id type="string" use=”Required”  maxOccurs="1" />
<xsd:element name="position” type="integer" use=”Required”  maxOccurs="1" />
 <xsd:element name="transfer_quantity” type="integer" use=”Required”  maxOccurs="1" />
</xsd:sequence>
<xsd:sequence>
<xsd:element name="trading_product” type="string" use=”Required”  maxOccurs="1" />
  <xsd:attribute name="type” type="security_id_type” use=”Required”  maxOccurs="1" />
  <xsd:element name="asset_type” type="asset_type" use=”Required”  maxOccurs="1" />
  <xsd:element name="currency" type="currency_type" use=”Required”  maxOccurs="1" />
</xsd:sequence>

Sample

Copy 
<?xml version="1" encoding="utf-8"?><instruction_set xmlns="http://www.interactivebrokers.com/fbfb_instruction_set" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.interactivebrokers.com/fbfb_instruction_set fbfb_instruction_set.xsd" creation_date="2020-08-25" id="1" version="1.1">
    <int_position_transfer id="237549678">
        <source_ib_acct>Ixxxxx1</source_ib_acct>
        <destination_ib_acct>Uxxxxx2</destination_ib_acct>
        <trading_product>
            <security_id type="ISIN">DE0005140008</security_id>
            <asset_type>STK</asset_type>
            <currency>USD</currency>
        </trading_product>
        <position>0</position>
        <transfer_quantity>1</transfer_quantity>
    </int_position_transfer>
</instruction_set>

XSD

Copy 
<xsd:complexType name="int_position_transfer" maxOccurs="unbounded" >
<xsd:sequence>
 <xsd:element name="id" type="Non-Negative-Integer" use=”Required”  maxOccurs="1" />
 <xsd:element name="source_ib_acct" type="string" use=”Required”  maxOccurs="1" />
 <xsd:element name="destination_ib_acct" type="string" use=”Required”  maxOccurs="1" />
 <xsd:element name="con_id type="string" use=”Required”  maxOccurs="1" />
 <xsd:element name="position” type="integer" use=”Required” maxOccurs="1" />
 <xsd:element name="transfer_quantity” type="integer" use=”Required”  maxOccurs="1" />
 <xsd:element name="currency" type="currency_type" use=”Required”  maxOccurs="1" />
<xsd:element name="contract_desc" type="string" use=”Optional”  maxOccurs="0" />
</xsd:sequence>

Sample

Copy 
<?xml version="1" encoding="UTF-8"?><instruction_set
    xmlns="http://www.interactivebrokers.com/fbfb_instruction_set"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://www.interactivebrokers.com/fbfb_instruction_set fbfb_instruction_set.xsd "
    creation_date="2019-01-11" id="2" version="1.1">
       <int_position_transfer id="1">
        <source_ib_acct>I1234567</source_ib_acct>
        <destination_ib_acct>U1234567</destination_ib_acct>
        <con_id>176573143</con_id>
         <contract_desc>MOMO</contract_desc>        
          <position>10</position>
        <transfer_quantity>2</transfer_quantity>
        <currency>USD</currency>
      </int_position_transfer>
</instruction_set>
Name Type Description

Name

Type

Description

creation_date

YYYY-MM-DD

Date/Time which the file was processed by IBKR.

id

Id of the instruction to which this node is a response

 

instr_id

Id of the instruction to which this node is a response

ID is a unique identifier which you create for each funding request.

status

PENDING

PROCESSED

REJECTED

Current status of the instruction associated with the instr_id.

code

String

Error code- (included only if there is an error)

description

String

Description of the error (included only if there is an error)

ib_instr_id

String

ID defined by IBKR.

Sample

Copy 
<?xml version="1" encoding="UTF-8" standalone="true"?><instr_result_set creation_date="2020-04-09-04:00" version="1.2" id="2" xmlns="http://www.interactivebrokers.com/fbfb_result_set">
    <result>
        <instr_id>2</instr_id>
        <status>PROCESSED</status>
        <ib_instr_id>1</ib_instr_id>
        <code/>
        <description/>
    </result>
</instr_result_set>