> For the complete documentation index, see [llms.txt](https://3commas.gitbook.io/3commas-official-api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://3commas.gitbook.io/3commas-official-api-docs/account/user-deposit-data.md).

# User deposit data

**Description:** Returns the data of deposit for a specific account using its ID<br>

{% hint style="info" %}
This endpoint works for the following exchanges: *Binance Spot*, *Binance US*, *OKX Spot*, *Binance Broker*
{% endhint %}

<br>

**Permission:** ACCOUNTS\_READ\
**Security:** SIGNED\ <br>

***

<mark style="color:blue;">**GET**</mark>

<mark style="color:blue;">**/ver1/accounts/{account\_id}/deposit\_data**</mark>

***

<br>

## Path Parameter<br>

**account\_id**     `integer`     <mark style="color:orange;">required</mark>\
Unique 3Commas ID for this exchange account entity

<br>

## Query Parameters<br>

**currency**     `string`     <mark style="color:orange;">required</mark>\
Currency code for what you want to get a data\
Example: `BTC`

**network**     `string`     <mark style="color:orange;">required</mark>\
Name of Network for this currency

<br>

## Response Parameters<br>

**address**     `string`\
The cryptocurrency wallet address for deposits and withdrawals

**network**     `string`\
Tag of address for this deposits

**currency**     `string`\
The amount of this currency currently locked in active orders

**total\_balance**     `string`\
The total balance in this currency and account

<br>

## Example Request<br>

```json

GET /ver1/accounts/76543210/deposit_data?currency=BTC&network=BTC
```

<br>

## Example Response and errors<br>

<details>

<summary>Status: 200 OK</summary>

<br>

```json
{
    "address": "1J6jZDFSeGfwfwJpS4SLqhVo7eo2DgkT9Q",
    "address_tag": "",
    "available_balance": "0.00031872",
    "in_orders": "0.0",
    "total_balance": "0.00031872"
}
```

</details>

<br>

<details>

<summary>Status: 400 Bad Request</summary>

<br>

```json
{
    "error": "record_invalid",
    "error_description": "Invalid parameters",
    "error_attributes": {
        "currency": [
            "is missing"
        ],
        "network": [
            "is missing"
        ]
    }
}
```

</details>

<br>

<details>

<summary>Status: 422 Unprocessable Entity</summary>

<br>

```json
{
    "error_description": "{\"code\"=>-9000, \"msg\"=>\"Deposits for this network are currently closed\"}",
    "error": "unknown_market_api_error"
}
```

</details>