# 외부 지갑으로 코인 전송

<mark style="color:green;">`POST`</mark> `https://{dashboard-domain}/v1.0/db/transfer`

#### Headers

| Name                                            | Type   | Description                 |
| ----------------------------------------------- | ------ | --------------------------- |
| Authorization<mark style="color:red;">\*</mark> | string | Bearer {{web-access-token}} |
| Content-Type<mark style="color:red;">\*</mark>  | string | application/json            |

#### Request Body

| Name                                          | Type    | Description  |
| --------------------------------------------- | ------- | ------------ |
| to\_address<mark style="color:red;">\*</mark> | string  | 전송할 외부 지갑 주소 |
| coin\_id<mark style="color:red;">\*</mark>    | int64   | 전송할 코인 ID    |
| quantity<mark style="color:red;">\*</mark>    | float64 | 코인의 양        |
| from\_address                                 | String  | 전송자 지갑 주소    |

{% tabs %}
{% tab title="200: OK 성공" %}

```javascript
{
    "return": 0,
    "message": "success",
    "value": {
        "au_id": 19,
        "coin_id": 2,
        "coin_symbol": "ONKLAY",
        "to_address": "0x84aD0A3041d95ad4c4fEA5d0e32Cb586447C23Cc",
        "quantity": 0.00001,
        "transfer_fee": 0.0014,
        "total_quantity": 0.00141,
        "reqid": "1643080859589744600",
        "transaction_id": "0xb9c29d31a3d8b5773f0d22c9d24cf65f8acbf1e858f40121c084bdc55b93c2be"
    }
}
```

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Example Body" %}

```
{
  "coin_id" : 2,
  "from_address" : "0x9cA2642bB6b076A35E7AdA0A7b09c1326361D769",
  "to_address": "0x84aD0A3041d95ad4c4fEA5d0e32Cb586447C23Cc",
  "quantity": 0.00001
}
```

{% endtab %}

{% tab title="Response Value" %}

<table><thead><tr><th width="173.33333333333331">key</th><th>data type</th><th>desc.</th></tr></thead><tbody><tr><td>au_id</td><td>int64</td><td>계정의 UID</td></tr><tr><td>coin_id</td><td>int64</td><td>코인 ID</td></tr><tr><td>coin_symbol</td><td>string</td><td>코인 심볼</td></tr><tr><td>to_address</td><td>string</td><td>보내는 지갑 주소</td></tr><tr><td>quantity</td><td>float64</td><td>보낸 량</td></tr><tr><td>transfer_fee</td><td>float64</td><td>전송 수수료</td></tr><tr><td>total_quantity</td><td>float64</td><td>최종 코인량</td></tr><tr><td>reqid</td><td>string</td><td>요청 ID</td></tr><tr><td>transaction_id</td><td>string</td><td>트랜잭션 ID</td></tr></tbody></table>
{% endtab %}

{% tab title="Example Curl" %}

```
curl --location --request POST 'https://{dashboard-domain}/v1.0/db/transfer' \
--header 'Authorization: Bearer eyJhbGciOiJIUz...' \
--header 'Content-Type: application/json' \
--data-raw '{
  "wallet_address": "0x123456789abcdefghjk",
  "coin_symbol": "ONIT",
  "quantity": "12345.90308503"
}'
```

{% endtab %}

{% tab title="Result Code" %}

| return        | message                       | desc.            |
| ------------- | ----------------------------- | ---------------- |
| 0             | success                       | 성공               |
| 500           | internal server error         | 내부 서버 에러         |
| 19000         | Internal DB error             | 내부 DB 에러         |
| 32104         | CoinID is invalid             | 유효하지 않은 CoinID   |
| 34002         | GetMeWalletList DB Scan Error | 내부 DB 에러         |
| 36001         | CoinSymbol is empty           | Request 데이터 오류   |
| 36002         | ToAddress is empty            | Request 데이터 오류   |
| 36003         | Quantity is empty             | Request 데이터 오류   |
| 36004         | Not enough Coin Quantity      | 전송할 코인량이 충분하지 않음 |
| {% endtab %}  |                               |                  |
| {% endtabs %} |                               |                  |
