# getMarketHistory

Provides the trading history for the designated market through this method:

```typescript
import { Nectar, KLineInterval } from "@wasd3rplay/nectar-sdk";

const nectar = new Nectar();

const now = new Date();
const minAgo = new Date(now.getTime() - 60 * 1000);

const histories = await nectar.getMarketHistory({
    symbol: "ETH_ETH:USDT_ETH",
    startTime: minAgo,
    endTime: now,
    interval: KLineInterval.SECOND_1
});
```

### Properties

* `symbol`
  * The market symbol
  * The symbol expression is a combination of `base_ticker`, a colon (':'), and `quote_ticker`.
* `startTime`
  * The staring point of the data to be retrieved
* `endTime`
  * The end point of the data to be retrieved
* `interval`
  * The time interval for summarizing trading history item in the data to be retrieved

#### Interval Choices

```
TICK_1 = "1T",
SECOND_1 = "1S",
SECOND_5 = "5S",
MINUTE_1 = "1",
MINUTE_60 = "60",
MINUTE_360 = "360",
MINUTE_720 = "720",
DAY_1 = "1D",
WEEK_1 = "1W",
MONTH_1 = "1M",
MONTH_12 = "12M"
```

### Result

The result of this method is a list of trade histories:

e.g.

```json
[
  {
    start_ts: 1695169493,
    end_ts: 1695169494,
    opening_price: '2108000000',   // 2108 USDT
    closing_price: '2000000000',   // 2000 USDT
    highest_price: '2200000000',   // 2200 USDT
    lowest_price: '1990000000',    // 1990 USDT
    volume: '1000000000000000000'  // 1 ETH
  },
  ...
]
```

* `start_ts`
  * The staring point of the history item as a timestamp
* `end_ts`
  * The staring point of the history item as a timestamp
* `opening_price`
  * The price at the starting point
* `closing_price`
  * The price at the end point
* `highest_price`
  * The highest price in the term
* `lowest_price`
  * The lowest price in the term
* `volume`
  * Total trade volume in the term
