> For the complete documentation index, see [llms.txt](https://ajaib.gitbook.io/ajaib-exchange-open-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajaib.gitbook.io/ajaib-exchange-open-api/api-references/images-and-media/get-account.md).

# Get Account

## Retrieve a trading account 

<mark style="color:green;">`GET`</mark> `/v1/account`

**Functionality:** Retrieves the aggregated portfolio of the exchange client. No sub-accounts yet.&#x20;

**Authentication:** Required

#### URL Parameters

<table><thead><tr><th width="182">Name</th><th width="107">Type</th><th width="123" data-type="checkbox">Mandatory</th><th>Description</th></tr></thead><tbody><tr><td>recvWindow</td><td>long</td><td>false</td><td>Number of milliseconds after timestamp the request is valid for. Refer to <a href="https://ajaib.gitbook.io/ajaib-exchange-open-api/getting-started/timing-security">this</a>.</td></tr><tr><td>timestamp</td><td>long</td><td>true</td><td>Timestamp when client sending request.</td></tr></tbody></table>

**Response Body**

<table><thead><tr><th width="167">Name</th><th width="158">Type</th><th>Description</th></tr></thead><tbody><tr><td>asset</td><td>string</td><td>The name of asset.</td></tr><tr><td>free</td><td>string</td><td>The total quantity of free assets.</td></tr><tr><td>locked</td><td>string</td><td>The total quantity of locked assets (used for open orders).</td></tr></tbody></table>

{% tabs %}
{% tab title="200 OK" %}

```javascript
{
  "balances": [
    {
      "asset": "BTC",
      "free": "10",
      "locked": "0"
    },
    {
      "asset": "IDR",
      "free": "3500000",
      "locked": "0"
    },
    {
      "asset": "USDT",
      "free": "10000",
      "locked": "0"
    }
  ]
}
```

{% endtab %}

{% tab title="401 Permission denied" %}

```
{
  "code": "EC0000999",
  "msg": "Unauthorized"
}
```

{% endtab %}
{% endtabs %}