ext_positions_transfer

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

  • ACATS is an automated platform that streamlines the transfer of customer accounts between US/Broker Dealers and Banks. We will reach out to your broker and initiate. This is the best option to transfer an entire brokerage account. Typically completes in 3 or 4 business days.

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

Name Type Description

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

type

FULL

Type will always be FULL.

sub_type

ACATS

 

Method used to initiate the transfer.

 

Details: Overview of transfer methods.

broker_id

Use 'ACATS' for value

DTC Number of the sending institution.

broker_name

Use /getECAEnumerations 'ACATS' for value

Name of the sending institution.

acct_at_broker

String

Client account number at sending institution.

ib_acct

String

IBKR Account Number of the client account that is initiating the transfer.

signature

String

Signature should match applicants first name middle initial (if applicable) last name suffix (if applicable)

*Data is case and space sensitive.

XSD

Copy 
<xsd:complexType name="ext_positions_transfer" maxOccurs="unbounded" >
<xsd:sequence>
 <xsd:element name="type" type="ACATS" maxOccurs="1" />
 <xsd:element name="id" type="Non-Negative-Integer " maxOccurs="1" />
 <xsd:element name="sub_type" type="FULL" maxOccurs="1" />
 <xsd:element name="broker_id" type="Non-Negative-Integer" maxOccurs="1" />
 <xsd:element name="broker_name" type="String" maxOccurs="1" />
 <xsd:element name="acct_at_broker" type="String" maxOccurs="1" />
 <xsd:element name="ib_acct" type="String" 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="2019-01-11" id="2" version="1.1">
    <ext_positions_transfer id="2447">
        <type>FULL</type>
        <sub_type>ACATS</sub_type>
        <broker_id>0226</broker_id>
        <broker_name>Wall Street Financial Group</broker_name>
        <acct_at_broker>SOL12345</acct_at_broker>
        <ib_acct>U199516</ib_acct>
        <signature>sample signature</signature>
</instruction_set>
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>PENDING</status>
        <ib_instr_id>1</ib_instr_id>
        <code/>
        <description/>
    </result>
</instr_result_set>