---
title: "Create Sub-Account Money Transfer"
method: POST
path: "/api/v1/sub-accounts/etoro-trading/money-transfers"
tags: ["Sub-Accounts - eToro Trading"]
---

# Create Sub-Account Money Transfer

`POST /api/v1/sub-accounts/etoro-trading/money-transfers`

## Request

- Base URL: `https://public-api.etoro.com`
- URL: `https://public-api.etoro.com/api/v1/sub-accounts/etoro-trading/money-transfers`
- Auth: OAuth 2
  - Authorization code
  - Scopes: `etoro-public:money:transfer`
- TypeScript: <https://skmtc.dev/etoro/apis/etoro-api/docs/api/v1/sub-accounts/etoro-trading/money-transfers/post.ts> (a function with typed inputs; its response is checked against the schema)

**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.

## Headers

- `x-request-id` string, uuid, required
- `x-api-key` string, password, required
- `x-user-key` string, password, required
- `x-sub-account-id` string, required

## Request body

- EtoroTradingSubAccountsMoneyTransferRequest
  - `amountInUsd` number, 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.

## Response `200`

The transfer was accepted

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden — the sub-account's gcid does not match the caller's token gcid
- `429`: Too Many Requests — the money-transfer dependency is throttling requests
- `500`: Internal Server Error — the transfer could not be completed

---

[API](https://skmtc.dev/etoro/apis/etoro-api.md) - [All operations](https://skmtc.dev/etoro/apis/etoro-api/llms.txt) - [OpenAPI document](https://skmtc.dev/etoro/apis/etoro-api/revisions/69c1fb266c35?raw)