---
api: 'Revolut X Crypto Exchange REST API'
---

# Get sub-accounts

List the Revolut X sub-accounts and the primary account of the authenticated user with their total balances converted to a requested currency, or to USD by default.
The user context is resolved based on the provided API key.

#### Rate limits

| Limit | Total tokens | Refresh rate | Token cost rule |
| :--- | ---: | :--- | :--- |
| **Per-second limit** | 10 | 10 tokens / second | 1 token / request |
| **Per-minute limit** | 100 | 100 tokens / minute | 1 token / request |

For retry guidance, see the `429 Rate Limit Exceeded` response below. The `Retry-After` header specifies the delay in milliseconds.

## Endpoint

GET `/1.0/sub-accounts`

## Parameters

### header parameters

- `X-Revx-Timestamp` (integer, required)
  Current timestamp in Unix epoch milliseconds. 
  Used to prevent replay attacks and construct the signature.
  Provided with other authentication headers.

- `X-Revx-Signature` (string, required)
  The Ed25519 signature of the request. 
  Provided with other authentication headers.
  
  :::tip
  See the [Authenticate requests](https://developer.revolut.com/docs/guides/crypto-exchange/get-started/authenticate-requests) guide for details on how to generate this.
  :::

### query parameters

- `convert_to` (string, optional)
  The ISO 4217 fiat currency code to value the total balances in. Conversion uses mid exchange rates and is for valuation only.

## Returns

### 200

OK

The list of sub-accounts.

#### Response attributes

- `data` (object)
  - `data.sub_accounts` (array of object)
      The user's sub-accounts, listed in ascending sub-account ID order.
      The default account is always included.
    - `data.sub_accounts[].name` (string)
        Sub-account name.
    - `data.sub_accounts[].total_balance` (object)
      - `data.sub_accounts[].total_balance.amount` (string)
          Total balance of the sub-account, valued in `convert_to`.
      - `data.sub_accounts[].total_balance.currency` (string)
          The ISO 4217 fiat currency code the total balance is denominated in.
    - `data.sub_accounts[].created_date` (integer)
        Sub-account creation date in Unix epoch milliseconds.
    - `data.sub_accounts[].updated_date` (integer)
        Sub-account last update date in Unix epoch milliseconds.
- `metadata` (object)
  - `metadata.timestamp` (integer)
      Timestamp in Unix epoch milliseconds.
  - `metadata.convert_to` (string)
      The ISO 4217 fiat currency code the total balances are valued in.

## Error responses

| HTTP status code | Description |
| --- | --- |
| 400 | Bad request |
| 401 | Unauthorized |
| 403 | Forbidden |
| 409 | Conflict |
| 429 | Rate Limit Exceeded |
| 5XX | Server Error |