internal_cash_transfer
https://[domain]/ws/fb/new-request
-
Used to internally transfer cash between two IBKR Accounts based on eligibility.
-
HTTP Request Type POST
-
Customer Type: Fully Disclosed, Non-Disclosed, and Advisor-Clients.

-
Non-Disclosed Clients:
-
Internally transfer cash 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
-

-
Our system does not allow internal transfers on Saturdays (any time), Sundays before 3PM EST, and on any evening between 11:45PM-12:30AM EST.
-
Batch processing every 30-60 seconds unless date_time_to_occur is specified. Transfer will be processed for date_time_to_occur. For instant transfers, use instant_cash_transfer.
-
Multiple transfer requests can be included within single instruction_set.

Name | Type | Description | ||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Name |
Type |
Description |
||||||||||||||||||||||
source_ib_acct |
String |
Account which funds are being sent from. |
||||||||||||||||||||||
destination_ib_acct |
String |
Account which funds are being sent to. |
||||||||||||||||||||||
amount |
Decimal |
Amount of cash being transferred. |
||||||||||||||||||||||
currency |
|
Currency of the funds being transferred. |
||||||||||||||||||||||
id |
ID is a unique identifier which you create for each funding request. |
|
||||||||||||||||||||||
date_time_to_occur |
2016-04-13T23:15:00+04:00 (UTC plus 4 hours) 2016-04-13T23:15:00-04:00 (UTC minus 4 hours) 2016-04-13T23:15:00Z (UTC |
Date which the transfer should take place. *This is optional. |
XSD
<xsd:complexType name="internal_cash_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="currency" type="currency_type" use="Required" maxOccurs="1" />
<xsd:element name="amount" type="Decimal” use="Required" maxOccurs="1" />
<xsd:element name="date_time_to_occur" type="date_time_to_occur” use="Optional" maxOccurs="1" />
</xsd:sequence>
Sample
<?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">
<internal_cash_transfer id="2450">
<source_ib_acct>U199516</source_ib_acct>
<destination_ib_acct>I114301</destination_ib_acct>
<amount>10000</amount>
<currency>USD</currency>
<date_time_to_occur>2016-04-13T23:15:00Z</date_time_to_occur>
</internal_cash_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
<?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>