# 코인 별 유동량 History 조회(그래프)

<mark style="color:blue;">`GET`</mark> `https://{dashboard-domain}/v1.0/db/app/coin/history`

#### Query Parameters

| Name                                           | Type   | Description                    |
| ---------------------------------------------- | ------ | ------------------------------ |
| coin\_id<mark style="color:red;">\*</mark>     | int64  | 코인 ID                          |
| candle<mark style="color:red;">\*</mark>       | string | "hour", "day", "week", "month" |
| page\_size<mark style="color:red;">\*</mark>   | int64  |                                |
| page\_offset<mark style="color:red;">\*</mark> | int64  |                                |

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

```javascript
{
    "return": 0,
    "message": "success",
    "value": {
        "coin_liquidity_count": 2,
        "coin_liquiditys": [
            {
                "base_date": "2022-02-04T00:00:00Z",
                "base_date_number": 1643932800,
                "acq_quantity": 0,
                "acq_count": 0,
                "cnsm_quantity": 0,
                "cnsm_count": 0,
                "acq_exchange_quantity": 300,
                "points_to_coins_count": 3,
                "cnsm_exchange_quantity": 0,
                "coins_to_points_count": 0
            },
            {
                "base_date": "2022-02-03T00:00:00Z",
                "base_date_number": 1643846400,
                "acq_quantity": 0,
                "acq_count": 0,
                "cnsm_quantity": 0,
                "cnsm_count": 0,
                "acq_exchange_quantity": 0,
                "points_to_coins_count": 0,
                "cnsm_exchange_quantity": 0,
                "coins_to_points_count": 0
            }
        ]
    }
}
```

{% endtab %}
{% endtabs %}

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

```
curl --location --request GET 'https://{dashboard-domain}/v1.0/db/app/coin/history?coin_id=2&candle=day&page_offset=0&page_size=5'
```

{% endtab %}

{% tab title="Response Value" %}

<table><thead><tr><th width="289.09026875470147">key</th><th>data type</th><th>desc.</th></tr></thead><tbody><tr><td>coin_liquidity_count</td><td>int64</td><td>코인 유동량 개수</td></tr><tr><td>coin_liquiditys</td><td>array</td><td>코인 유동량 정보</td></tr><tr><td>base_date</td><td>string</td><td>기준날짜</td></tr><tr><td>base_date_number</td><td>int64</td><td>기준날짜 (second)</td></tr><tr><td>acq_quantity</td><td>float64</td><td>외부 지갑에서 입금한 량</td></tr><tr><td>acq_count</td><td>int64</td><td>입금 횟수</td></tr><tr><td>cnsm_quantity</td><td>float64</td><td>외부지갑으로 전송한 량</td></tr><tr><td>cnsm_count</td><td>int64</td><td>전송 횟수</td></tr><tr><td>acq_exchange_quantity</td><td>float64</td><td>포인트 -> 코인 전환량</td></tr><tr><td>points_to_coins_count</td><td>int64</td><td>포인트 -> 코인 전환 횟수</td></tr><tr><td>cnsm_exchange_quantity</td><td>float64</td><td>코인 -> 포인트 전환량</td></tr><tr><td>coins_to_points_count</td><td>int64</td><td>코인 -> 포인트 전환 횟수</td></tr></tbody></table>
{% endtab %}

{% tab title="Result Code" %}

| return        | message                         | desc. |
| ------------- | ------------------------------- | ----- |
| 0             | success                         | 성공    |
| 33007         | Get app coin liquidity db error | DB 에러 |
| {% endtab %}  |                                 |       |
| {% endtabs %} |                                 |       |
