Transfer Positions Externally (ACATS, ATON, FOP, DWAC, Complex Asset Transfer)

POST

/gw/api/v1/external-asset-transfers

Initiate request to submit external position transfer. Methods- ACATS, ATON, Basic FOP, FOP, DWAC. More information on transfer methods can be found here - https://www.interactivebrokers.com/campus/trading-lessons/cash-and-position-transfers/

Scope: transfers.write
Security Policy: Signed JWT

Initiate request to submit external position transfer. Methods- ACATS, ATON, Basic FOP, FOP, DWAC. More information on transfer methods can be found here - https://www.interactivebrokers.com/campus/trading-lessons/cash-and-position-transfers/<br><br>**Scope**: `transfers.write`<br>**Security Policy**: `Signed JWT`

Path parameters

client-idstringRequired

The client's clientId

Request

This endpoint expects an object.

instructionTypeenumRequired

Allowed values:

instructionobjectRequired

Response

Accepts request to create a new instruction asynchronously

statusdouble

instructionSetIddouble

instructionResultobject

Errors

400

Bad Request Error

403

Forbidden Error

422

Unprocessable Entity Error

500

Internal Server Error

$	curl -X POST https://api.ibkr.com/gw/api/v1/external-asset-transfers \
>	-H "Content-Type: application/json" \
>	-d '{
>	"instructionType": "FOP",
>	"instruction": {
>	"accountId": "U46377",
>	"clientInstructionId": 7013038,
>	"contraBrokerAccountId": "12345678A",
>	"contraBrokerDtcCode": "534",
>	"direction": "IN",
>	"quantity": 1000,
>	"tradingInstrument": {
>	"conid": 12123,
>	"currency": "USD"
>	}
>	}
>	}'

1	{
2	"status": 202,
3	"instructionSetId": 1703,
4	"instructionResult": {
5	"clientInstructionId": 1013031,
6	"instructionType": "FOP",
7	"instructionStatus": "PENDING",
8	"instructionId": 43091814
9	}
10	}