# App 포인트 별 유동량 History 조회(그래프)

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

#### Query Parameters

| Name                                           | Type   | Description                    |
| ---------------------------------------------- | ------ | ------------------------------ |
| app\_id<mark style="color:red;">\*</mark>      | int64  | app id                         |
| candle<mark style="color:red;">\*</mark>       | string | "hour", "day", "week", "month" |
| point\_id<mark style="color:red;">\*</mark>    | int64  | point id                       |
| 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": {
        "point_liquidity_count": 2,
        "point_liquiditys": [
            {
                "base_date": "2022-02-04T00:00:00Z",
                "base_date_number": 1643932800,
                "acq_quantity": 4400,
                "acq_count": 4,
                "cnsm_quantity": 0,
                "cnsm_count": 0,
                "acq_exchange_quantity": 0,
                "points_to_coins_count": 3,
                "cnsm_exchange_quantity": -300,
                "coins_to_points_count": 0
            },
            {
                "base_date": "2022-02-03T00:00:00Z",
                "base_date_number": 1643846400,
                "acq_quantity": 2000,
                "acq_count": 5,
                "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://20.194.125.150:51031/v1.0/db/app/point/history?app_id=1&point_id=1&candle=month&page_offset=0&page_size=5'
```

{% endtab %}

{% tab title="Response Value" %}

<table><thead><tr><th width="252.13953488372093">key</th><th>data type</th><th>desc.</th></tr></thead><tbody><tr><td>point_liquidity_count</td><td>int64</td><td>포인트 유동량 개수</td></tr><tr><td>point_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>int64</td><td>획득량</td></tr><tr><td>acq_count</td><td>int64</td><td>획득 횟수</td></tr><tr><td>cnsm_quantity</td><td>int64</td><td>소모량</td></tr><tr><td>cnsm_count</td><td>int64</td><td>소모 횟수</td></tr><tr><td>acq_exchange_quantity</td><td>int64</td><td>코인 -> 포인트 전환량</td></tr><tr><td>points_to_coins_count</td><td>int64</td><td>포인트 -> 코인 전환 횟수</td></tr><tr><td>cnsm_exchange_quantity</td><td>int64</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                          | 성공    |
| 33006         | Get app point liquidity db error | DB 에러 |
| {% endtab %}  |                                  |       |
| {% endtabs %} |                                  |       |
