> For the complete documentation index, see [llms.txt](https://doc.bittap.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.bittap.org/developer-guides/api-reference/sendbtc/transferbtc.md).

# TransferBtc

<mark style="color:green;">`POST`</mark> /api/transfer-btc

**Headers**

| Name          | Value              |
| ------------- | ------------------ |
| Content-Type  | `application/json` |
| Authorization | `Bearer <token>`   |

**Body**

| Name        | Type   | Description                                   |
| ----------- | ------ | --------------------------------------------- |
| `wallet_id` | string | The end user's wallet id                      |
| recv\_addr  | string | BTC address to send to.                       |
| amount      | int64  | Amount to send in sats                        |
| min\_conf   | int32  | Minimized confirmations to be as a legal UTXO |
| fee\_rate   | int64  | Fee rate in sat/vB                            |

**Request**

```json
{
    "wallet_id":"23a06ee3-050a-46f7-9eec-68d95471dd6c",
    "recv_addr": "bc1qp9zm6x5q6y02036l2q93936c4fs3acjr546yly",
    "amount": 20000000,
    "min_conf":6,
    "fee_rate":4
}
```

**Response**

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

```json
{
    "code": 0,
    "data": {
        "funded_psbt": ["cHNidP8BAHECAAAAAZGPYjWItkw0iOLPoanYSbYw+ibmnOqbnaix+sNsbImqAQAAAAD/////AgAtMQEAAAAAFgAUK2uwcXCF0j52o+XLVed9PD3MD57gJiEKAAAAABYAFAtC6UPwxusmdFdvhnMxvQmlkLS9AAAAAAABAN8CAAAAAAEBFDSqn+dU1Uxa/T8LJv3WP1PjR0wI3gfrGdECY7WMGZcCAAAAAP////8CgJaYAAAAAAAWABQra7BxcIXSPnaj5ctV5308PcwPnmpvUgsAAAAAFgAUC0LpQ/DG6yZ0V2+GczG9CaWQtL0CSDBFAiEA5mci4K5/n+MizCD/DvNDnxgx3YsGJ0CCtTr7u90liscCIFOHtC3VUOiZKC3Gf6s62MvJMPJVVgrDTPZ2LHeHujt2ASEC01BZ4Z28cGjI+8G+YVQTa165hkxiYML89466wQgVeMMAAAAAAQEfam9SCwAAAAAWABQLQulD8MbrJnRXb4ZzMb0JpZC0vQEDBAEAAAAiBgMogeczlXHujeNLANvMEPQj1w3V1sxRx9bs8zJVMR0E4BgAAAAAVAAAgAAAAIAAAACAAAAAAAAAAAAAAAA="]
    },
    "message": "",
    "traceid": "a73c5849-6a10-4bda-a411-d6c236277939"
}
```

{% endtab %}

{% tab title="400" %}

```json
{
  "error": "Invalid request"
}
```

{% endtab %}
{% endtabs %}
