Sign in

v1

latestOpenAPI 3.0.12026-07-26171200932.8 KB
Sub-Accounts - eToro Trading

Create Sub-Account Money Transfer

Rate limit: 60 requests per 60 seconds. This is the default shared quota — it is shared with every other endpoint that has no dedicated limit, so requests across those endpoints all draw from the same budget.

Executes a money transfer between the authenticated caller and the sub-account identified by the x-sub-account-id header. The amount must be positive with up to two decimal places. Direction ToSubAccount moves funds from the caller to the sub-account; FromSubAccount moves funds from the sub-account back to the caller.

post/api/v1/sub-accounts/etoro-trading/money-transfers

Headers

x-request-idstring uuid required
Example:275c4e01-c523-403d-a967-1539e72522c3

A unique request identifier.

x-api-keystring password required
Example:lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663

API key for authentication.

x-user-keystring password required
Example:eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_

User-specific authentication key.

x-sub-account-idstring required

The encrypted sub-account identifier. The backend validates that it decrypts to a sub-account owned by the caller's token gcid and resolves the target compensation CID.

Request body

amountInUsdnumber required

The money-transfer amount in USD. Must be positive and have up to two decimal places.

direction'FromSubAccount' | 'ToSubAccount' required

The transfer direction. ToSubAccount moves funds from the caller to the sub-account; FromSubAccount moves funds from the sub-account back to the caller. Parsing is case-insensitive.

Example request

{
  "amountInUsd": 250.55,
  "direction": "ToSubAccount"
}

Response

The transfer was accepted