Transfer Positions Internally

POST

/gw/api/v1/internal-asset-transfers

POST

/gw/api/v1/internal-asset-transfers

curl -X POST https://localhost:5000/gw/api/v1/internal-asset-transfers \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "instructionType": "INTERNAL_POSITION_TRANSFER",
  "instruction": {
    "clientInstructionId": 7013044,
    "sourceAccountId": "U399192",
    "targetAccountId": "U87440",
    "transferQuantity": 6,
    "tradingInstrument": {
      "conid": 459200101,
      "currency": "USD",
      "tradingInstrumentDescription": {
        "assetType": "STK",
        "securityId": "459200101",
        "securityIdType": "ISIN"
      }
    }
  }
}'

{
  "status": 202,
  "instructionSetId": 2614,
  "instructionResult": {
    "clientInstructionId": 7008152,
    "instructionType": "INTERNAL_POSITION_TRANSFER",
    "instructionStatus": "PENDING",
    "instructionId": 43092590
  }
}

Transfer positions internally between two accounts with Interactive Brokers

Scope: transfers.write
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

Request to transfer a position between two Interactive Brokers accounts.

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