dwac

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

  • Initiate DWAC for existing account(s).

    • An electronic method of transferring shares registered in the customer's name on the books of the transfer agent between participating broker/dealers with the transfer agent serving as a custodian. DWAC usually refers to new or certified paper shares to be electronically transferred.

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

Name Type Description

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

direction

IN

Direction will always be IN for dwac.

ib_acct

String

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

non_ib_acct

String

Client account number at the third party broker. 

account_title

String

Account title of the receiving account at IBKR.

tax_id

String

Tax ID listed on file of the IBKR account.

reference_id

String

Reference ID created by counter party.

security_id

String

CUSIP/ISIN number of the security being transferred.

quantity

Integer

Number of shares being transferred in/out

asset_type

BILL

BOND

CASH

OPT

STK

WAR

Product type. 

XSD

Copy 
<xsd:complexType name="dwac" maxOccurs="unbounded" ><xsd:sequence>
 <xsd:element name="direction" type="IN" maxOccurs="1" />
 <xsd:element name="ib_acct" type="String" maxOccurs="1" />
 <xsd:element name="non_ib_acct" type="String" maxOccurs="1" />
 <xsd:element name="account_title" type="String" maxOccurs="1" />
 <xsd:element name="tax_id" type=”String" maxOccurs="1" />
 <xsd:element name="reference_id" type="Integer" maxOccurs="1" />
</xsd:sequence>
<xsd:sequence>
 <xsd:element name="asset_type" type="asset_type" maxOccurs="Unbounded" />
 <xsd:element name="security_id " type="string" maxOccurs="Unbounded" />
 <xsd:element name="quantity" type="non-negative integer" maxOccurs="Unbounded" />
</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">
    <dwac id="2449">
        <direction>IN</direction>
        <ib_acct>U199516</ib_acct>
        <non_ib_acct>12345678A</non_ib_acct>
        <account_title>Special Company Holding LLC</account_title>
        <tax_id>123456789</tax_id>
        <reference_id>12345</reference_id>
        <security_id>459200101</security_id>
        <quantity>1000</quantity>
        <asset_type>STK</asset_type>
    </dwac>
</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>