Get max transferable amount

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.

---

Returns the maximum amount the customer may transfer from the specified source account to the specified destination account.

GET /api/v1/money/transferable-balance

Get max transferable amount

cURL

curl --request GET \
  --url https://public-api.etoro.com/api/v1/money/transferable-balance \
  --header 'x-api-key: <api-key>' \
  --header 'x-request-id: <x-request-id>' \
  --header 'x-user-key: <api-key>'

200

{
  "sourceAccount": {
    "accountId": "ACC-100100"
  },
  "destinationAccount": {
    "accountId": "ACC-100100"
  },
  "transferableAmount": 1500.5,
  "currency": "USD",
  "amountInUsd": 1500.5,
  "exchangeRate": 1
}

Authorizations

apiKeyAuth & userKeyAuthoauth2

x-api-key · string · header · default: lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663 · required

API key of the application. Only valid together with the x-user-key header — the pair is an alternative to OAuth bearer authentication, never sent alongside it. The pair is granted the same permissions the operation's OAuth scopes describe.

Demo credential for trying the API from these docs: lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663

x-user-key · string · header · default: eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_ · required

User-specific authentication key. Only valid together with the x-api-key header — the pair is an alternative to OAuth bearer authentication, never sent alongside it.

Demo credential for trying the API from these docs: eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_

Headers

x-request-id · string<uuid> · required

A unique request identifier.

Example:

"49e4adf8-1f0e-443d-b758-7b1d9fe5810b"

Query Parameters

sourceAccountType · enum<string> · required

Source account type (trading, options, or cash).

Available options: trading, options, cash, moneyFarm

sourceAccountId · string · required

Source account identifier.

destinationAccountType · enum<string> · required

Destination account type (trading, options, or cash).

Available options: trading, options, cash, moneyFarm

destinationAccountId · string · required

Destination account identifier.

Response

200

application/json

Transferable amount and account identifiers for the route.

Transferable balance for a source/destination account pair

sourceAccount · object · required

Confirmed source account.

Show child attributes

destinationAccount · object · required

Confirmed destination account.

Show child attributes

transferableAmount · number<double> · required

Maximum amount the user may transfer on this route in Currency.

Example:

1500.5

currency · string · required

ISO 4217 alphabetic currency code for transferableAmount.

Pattern: ^[A-Z]{3}$

Example:

"USD"

amountInUsd · number<double> · required

transferableAmount expressed in USD for display or analytics.

Example:

1500.5

exchangeRate · number<double> · required

Raw FX rate used to derive amountInUsd from the amount in currency.

Example:

1