> For the complete documentation index, see [llms.txt](https://docs.autoproof.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.autoproof.dev/telegram-mini-apps-api/wallets.md).

# Wallets

## Create a wallet for logged user

<mark style="color:green;">`POST`</mark> `/api/v1/users/wallets`

**Headers**

| Name          | Value              |
| ------------- | ------------------ |
| Content-Type  | `application/json` |
| Authorization | initData from TG   |

**Body**

| Name      | Type   | Required |
| --------- | ------ | -------- |
| `address` | string | +        |
| `name`    | string | -        |

Example

```json
{
    "address": "0x45ro3efn3efe300f3e0f3efe0feifffe30fi",
    "name": "Ton Space wallet"
}
```

**Response**

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

```json
{
    "result": true,
    "message": "Wallet added or created",
    "wallet": {
        "id": "5755aebf-cc56-4893-b334-fbb8e774457e",
        "created_at": "2024-07-13T14:01:47.953Z",
        "updated_at": "2024-07-13T14:32:02.670Z",
        "deleted_at": null,
        "name": "Ton Space wallet",
        "address": "0x45ro3efn3efe300f3e0f3efe0feifffe30fi",
        "owner_id": 11
    }
}
```

{% endtab %}

{% tab title="400" %}

<pre class="language-json"><code class="lang-json"><strong>{
</strong>    "result": false,
    "message": {
        "address": [
            "This field is required."
        ]
    }
}
</code></pre>

{% endtab %}
{% endtabs %}

## Wallets list

<mark style="color:green;">`GET`</mark> `/api/v1/users/wallets`

**Headers**

| Name          | Value              |
| ------------- | ------------------ |
| Content-Type  | `application/json` |
| Authorization | initData from TG   |

**Response**

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

```json
{
    "result": true,
    "message": "Wallets belonged to user",
    "wallets": [
        {
            "id": "914a9adf-5a51-456f-8502-4f9b8247035d",
            "created_at": "2024-07-13T14:33:55.375Z",
            "updated_at": "2024-07-13T14:33:55.402Z",
            "deleted_at": null,
            "name": "Ton Space wallet",
            "address": "0x45ro3efn3efe300f3e0f3efe0feifffe30fid",
            "owner_id": 11
        },
        {
            "id": "5755aebf-cc56-4893-b334-fbb8e774457e",
            "created_at": "2024-07-13T14:01:47.953Z",
            "updated_at": "2024-07-13T14:33:49.398Z",
            "deleted_at": null,
            "name": "Ton Space wallet",
            "address": "0x45ro3efn3efe300f3e0f3efe0feifffe30fi",
            "owner_id": 11
        },
        {
            "id": "ad1f56f6-6a01-421b-b293-7ea41b147e19",
            "created_at": "2024-07-13T13:43:47.080Z",
            "updated_at": "2024-07-13T13:57:04.836Z",
            "deleted_at": null,
            "name": "___erf",
            "address": "___wdf",
            "owner_id": 11
        },
        {
            "id": "9d7b6f41-f510-4cbe-a9ea-23af0bfaf97a",
            "created_at": "2024-07-13T13:41:45.456Z",
            "updated_at": "2024-07-13T13:43:34.449Z",
            "deleted_at": null,
            "name": "wallet_name",
            "address": "wallet_address0",
            "owner_id": 11
        },
        {
            "id": "6fd4c352-c677-40f4-affc-34287c04baa4",
            "created_at": "2024-07-13T13:41:29.428Z",
            "updated_at": "2024-07-13T13:41:33.170Z",
            "deleted_at": null,
            "name": "wallet_name",
            "address": "wallet_address3",
            "owner_id": 11
        },
        {
            "id": "c9080346-dd64-4eb4-8868-48c9e190aaa9",
            "created_at": "2024-07-13T13:34:22.771Z",
            "updated_at": "2024-07-13T13:36:55.434Z",
            "deleted_at": null,
            "name": "wallet_name2",
            "address": "wallet_address222",
            "owner_id": 11
        }
    ]
}
```

{% endtab %}
{% endtabs %}

## Delete a wallet

<mark style="color:green;">`DELETE`</mark> `/api/v1/users/wallets`

**Headers**

| Name          | Value              |
| ------------- | ------------------ |
| Content-Type  | `application/json` |
| Authorization | initData from TG   |

**Body**

| Name | Type   | Required |
| ---- | ------ | -------- |
| `id` | string | +        |

Example

```json
{
    "id": "5755aebf-cc56-4893-b334-fbb8e774457e"
}
```

**Response**

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

```json

{
    "result": true,
    "message": "Wallets has been deleted"
}
```

{% endtab %}

{% tab title="400" %}

```json
{
    "result": false,
    "message": "Validation errors: Wallet matching query does not exist."
}
```

{% endtab %}
{% endtabs %}