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

POST

/gw/api/v2/external-asset-transfers

POST

/gw/api/v2/external-asset-transfers

curl -X POST https://localhost:5000/gw/api/v2/external-asset-transfers \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "instructionType": "FOP",
  "instruction": {
    "accountId": "U46377",
    "clientInstructionId": 7013038,
    "contraBrokerAccountId": "12345678A",
    "contraBrokerDtcCode": "534",
    "currency": "USD",
    "direction": "IN",
    "positions": [
      {
        "conid": 12123,
        "quantity": 1000
      }
    ]
  }
}'

{
  "status": 202,
  "instructionSetId": 1703,
  "instructionResult": {
    "clientInstructionId": 1013031,
    "instructionType": "FOP",
    "instructionStatus": "PENDING",
    "instructionId": 43091814
  }
}

Initiate request to submit external position transfer. Methods- 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- 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`

Authentication

AuthorizationBearer

RS256-signed JWT access token signed with your registered private key.

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

HTTP status code for the request.

instructionSetIddouble

Identifier of the instruction set grouping the submitted instructions.

instructionResultobjectOptional

Result of the submitted instruction.

Errors

400

Bad Request Error

403

Forbidden Error

422

Unprocessable Entity Error

500

Internal Server Error