complex_asset_transfer (International FOP for Non-Disclosed)

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

  • Transfers are generally completed within 3-5 business days, but this depends on your third-party broker. FOP notices are valid for five business days before expiring. Once the notice has expired IBKR will not accept the shares.

  • Transfer of Non-US, bonds, structured products, and options between IBKR and another Non-US Financial Constitution. For incoming transfers, the FOP request is a notification notifying IBKR of the incoming transfer. Transfer of assets will need to be initiated at the third-party broker.

  • An FOP deposit is only a notification of incoming securities while an FOP withdrawal actually transfers securities out.

  • More Information

Place of Settlement (pset_bic) will determine which fields are required.

Y= Yes required

N= No , not required

PSET reag_deag_bic buyr_sell_bic member_account_id safekeeping_account
OCSDATWWXXX Y Y N N
CIKBBEBBXXX Y Y N N
CEDELULLXXX Y N Y Y
MGTCBEBEECL N N Y Y
SICVFRPPXXX Y Y N N
DAKVDEFFXXX Y N Y Y
KELRHUHBXXX Y Y N Y
MOTIITMMXXX Y Y N Y
NECINL2AXXX Y Y N N
VPSNNOKKXXX Y Y N Y
KDPWPLPWXXX Y Y N Y
IBLSPTPPXXX Y Y N N
IBRCESMMXXX Y Y N N
VPCSSESSXXX Y Y N Y
INSECHZZXXX Y Y N Y
CRSTGB22XXX N N Y N
XTAEILITXXX Y Y N Y
LCDELV22XXX Y Y N N
NADCRUMMXXX Y N N Y
DTCYUS33XXX N N Y Y
CADSCA81XXX N N Y Y
INDEMXMMXXX Y Y Y N
XHKCHKH1XXX N N Y N
CDPLSGSGXXX Y Y N N
JJSDJPJTXXX Y Y N N
CAETAU21XXX N Y N Y

IBKR's settlement instructions are available by request only. To receive this information, please contact dam@ibkr.com.

Name Type Description Usage

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

 Required.
nonDisclosed

true

false

   Required
account_type

INDIVIDUAL

JOINT

ORG

TRUST

 Account Type (at Financial Institution) Required
broker_name Use /get-info to query expected Broker Name. Optionally, send email to dam@ibkr.com and we can provide. Name of Financial Institution Required
trade_date YYYY-MM-DD Current or future date. trade date cannot exceed value date. Date should not be more than 30 days in advance. Required
settle_date YYYY-MM-DD   Required
depository_id String ID at Depository. Required
pset_bic String Place of Settlement Required
reag_deag_bic String ID code of delivering agent. See validations table.
buyr_sell_bic String Id Code of Buyer or Seller. See validations table.
member_account_id String Account ID for market. See validations table.
safekeeping_account String Safekeeping Account See validations table.

direction

IN

OUT

Indicate if this is an incoming our outgoing transfer.

IN = Incoming to IBKR

OUT= Transferring out to third party Broker.

Required

ib_acct_id

String

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

Required

contra_broker_acct_id

String

Client account number at the third party broker. 

Required

country

Alpha-3 code (ISO)

Country which the contra broker is located.

 Required

contract_name

String

Name of the contact at the contra broker.

 Required

contact_email

String

Email of the contact at the contra broker.

Note: We use REGEX to validate the email. Validations outlined here.

Required

contact_phone

String

Phone number of the contact at the contra broker.

Note: We use Google API to validate the Phone Number. Validations outlined here.

Required

security_id

String

CUSIP/ISIN number of the security being transferred.

Required IF providing ISIN or CUSIP.

quantity

Non-Negative Integer

Number of shares being transferred in/out

 Required

asset_type

BILL

BOND

CASH

FUND

OPT

STK

WAR

Product type. 

Required IF providing ISIN or CUSIP.

security_id_type

CUSIP

ISIN

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

 Required IF providing ISIN or CUSIP.

con_id

String

Unique Contract ID assigned by Interactive Brokers.

 Required if providing con_id.

currency

USD

Currency of the assets being transferred. 

Required IF providing ISIN or CUSIP.

Sample

There are 2 options for submitting basic_fop request

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">
 <complex_asset_transfer id="222" non_disclosed="true">
<direction>IN</direction>
<ib_acct_id>U123456</ib_acct_id>
<contra_broker_info>
<account_type>ORG</account_type>
 <account_title>Tester Tester</account_title>
<broker_name>GF Securities</broker_name>
 <depository_id>1234</depository_id>
<contra_broker_acct_id> as3456567678578N</contra_broker_acct_id>
<country>USA</country> <contact_name>as</contact_name>
<contact_email>a@gmail.com</contact_email>
 <contact_phone>2039126155</contact_phone>
</contra_broker_info>
<trading_product>
<security_id type="ISIN">US0378331005</security_id>
 <asset_type>STK</asset_type>
<currency>USD</currency>
</trading_product>
<quantity>10</quantity>
<trade_date>2022-05-18</trade_date>
 <settle_date>2022-05-20</settle_date>
<pset_bic>LCDELV22XXX</pset_bic>
<reag_deag_bic>CH100164</reag_deag_bic>
<buyr_sell_bic>320043</buyr_sell_bic>
<member_account_id>12334</member_account_id>
<safekeeping_account>123456</safekeeping_account>
</complex_asset_transfer> </instruction_set>
<?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">
 <complex_asset_transfer id="222" nonDisclosed="true" >
 <direction>IN</direction>
<ib_acct_id>U123456</ib_acct_id>
<contra_broker_info>
<account_type>ORG</account_type>
 <account_title>Tester Tester</account_title>
<broker_name>GF Securities</broker_name>
 <depository_id>1234</depository_id>
<contra_broker_acct_id> as3456567678578N</contra_broker_acct_id>
 <country>USA</country>
<contact_name>as</contact_name>
<contact_email>a@gmail.com</contact_email>
 <contact_phone>2039126155</contact_phone>
 </contra_broker_info> <con_id>265598</con_id>
 <quantity>10</quantity>
 <trade_date>2022-05-18</trade_date>
 <settle_date>2022-05-20</settle_date>
<pset_bic>LCDELV22XXX</pset_bic>
<reag_deag_bic>CH100164</reag_deag_bic>
<buyr_sell_bic>320043</buyr_sell_bic>
<member_account_id>12334</member_account_id>
<safekeeping_account>123456</safekeeping_account>
</complex_asset_transfer>
 </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.0" encoding="UTF-8" standalone="yes"?>
<instr_result_set xmlns="http://www.interactivebrokers.com/fbfb_result_set"
    id="88002148" version="1.2" creation_date="2022-03-03-05:00">
    <result>
        <instr_id>12</instr_id>
        <status>PENDING</status>
        <ib_instr_id>43080141</ib_instr_id>
        <code></code>
        <description></description>
    </result>
    <result>
        <instr_id>13</instr_id>
        <status>PENDING</status>
        <ib_instr_id>43080142</ib_instr_id>
        <code></code>
        <description></description>
    </result>
</instr_result_set>