# Счета в криптовалюте

{% hint style="danger" %}
**Внимание -** Данное API ты используешь на свой страх и риск, мы не несем ответственности за сохранность данных созданных тобой счетов через представленное API, но приложим все усилия для их сохранности и безопастности. Ты не должен использовать методы API представленные на этой странице, если их использование нарушает законодательство Украины, Европейского союза или США.
{% endhint %}

{% hint style="info" %}
Все счета отображаются в карточке контакта в личном кабинете. Так же по каждому счету ведется журнал операций. 
{% endhint %}

## Получить список счетов

<mark style="color:blue;">`GET`</mark> `https://app.cleverapp.pro/api/v1/getContactCryptoAccounts`

Этот метод позволяет получить список счетов указанного контакта

#### Query Parameters

| Name        | Type    | Description |
| ----------- | ------- | ----------- |
| contact\_id | Integer | ID          |

{% tabs %}
{% tab title="200: OK Запрос успешно обработан" %}

```
{
  "data": [
    {
      "id": 2,
      "currency": "BTC",
      "amount": "0.24624642624",
      "created_at": "2022-11-24T11:19:42+00:00",
      "updated_at": "2022-11-24T11:21:57+00:00"
    }
  ]
}
```

{% endtab %}
{% endtabs %}

## Создать счет

<mark style="color:green;">`POST`</mark> `https://app.cleverapp.pro/api/v1/addContactCryptoAccount`

Этот метод позволяет создать счет для указанного контакта.

#### Request Body

| Name        | Type    | Description             |
| ----------- | ------- | ----------------------- |
| contact\_id | Integer | ID контакта             |
|             | String  | Код валюты. Пример: BTC |

{% tabs %}
{% tab title="200: OK Счет успешно создан" %}

```
{
  "data": {
    "id": 2,
    "currency": "BTC",
    "amount": 0,
    "created_at": "2022-11-24T11:19:42+00:00",
    "updated_at": "2022-11-24T11:19:42+00:00"
  }
}
```

{% endtab %}

{% tab title="422: Unprocessable Entity Аккаунт уже существует" %}

```
{
  "errors": {
    "currency": [
      "Account with the currency already exists"
    ]
  }
}
```

{% endtab %}
{% endtabs %}

## Удалить счет

<mark style="color:green;">`POST`</mark> `https://app.cleverapp.pro/api/v1/deleteContactCryptoAccount`

Этот метод позволяет удалить счет контакта

#### Request Body

| Name        | Type    | Description |
| ----------- | ------- | ----------- |
| account\_id | Integer | ID счета    |

{% tabs %}
{% tab title="204: No Content Счет успешно удален" %}

```
{
    // Response
}
```

{% endtab %}

{% tab title="422: Unprocessable Entity Счет не может быть удален, так как имеет положительный баланс" %}

```
{
  "errors": {
    "account_id": [
      "You can not delete the account with a balance 0.24624642624 BTC"
    ]
  }
}
```

{% endtab %}
{% endtabs %}

{% hint style="danger" %}
Счет может быть удален только если имеет нулевой баланс.
{% endhint %}

## Зачислить сумму на счет

<mark style="color:green;">`POST`</mark> `https://app.cleverapp.pro/api/v1/addFundsToContactCryptoAccount`

Этот метод позволяет зачислить средства на счет контакта

#### Request Body

| Name        | Type    | Description         |
| ----------- | ------- | ------------------- |
| account\_id | Integer | ID счета            |
| amount      | Number  | Сумма транзакции    |
| Description | String  | Описание Транзакции |

{% tabs %}
{% tab title="200: OK Счет успешно оплачен" %}

```
{
  "data": {
    "id": 2,
    "currency": "BTC",
    "amount": 0.34624642624,
    "created_at": "2022-11-24T11:19:42+00:00",
    "updated_at": "2022-11-24T11:20:18+00:00"
  }
}
```

{% endtab %}
{% endtabs %}

## Списать сумму со счета

<mark style="color:green;">`POST`</mark> `https://app.cleverapp.pro/api/v1/withdrawFundsFromContactCryptoAccount`

Этот метод позволяет списать средства со счета контакта

#### Request Body

| Name        | Type    | Description         |
| ----------- | ------- | ------------------- |
| account\_id | Integer | ID счета            |
| amount      | Number  | Сумма транзакции    |
| Description | String  | Описание транзакции |

{% tabs %}
{% tab title="200: OK Списание успешно проведено" %}

```
{
    // Response
}
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.cleverapp.pro/dlya-razrabotchikov/dokumentaciya-i-rabota-s-api/kontakty/scheta-v-kriptovalyute.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.