### Instruments group methods

Source: https://www.dukascopy.com/trading-tools/api/documentation/instruments

Get the list of instruments and their details from Dukascopy Bank.

```APIDOC
## GET /api/instrumentList

### Description
Get the list of instruments and their details.

### Method
GET

### Endpoint
https://freeserv.dukascopy.com/2.0/?path=api/instrumentList

### Parameters
#### Query Parameters
- **key** (string) - Optional - Apply to get key.
- **instruments** (string) - Optional - Instrument ids separated by comma. Do not specify to get a full list of instruments.
- **fields** (string) - Optional - List of fields separated by comma (id, name, pipValue, nameLong). Default: id,name,pipValue,nameLong

### Response
#### Success Response (200)
- **Array** (array) - Contains instrument details.

#### Response Example
```json
[
  {
    "id": "1.737393",
    "name": "EUR/USD",
    "pipValue": 0.0001,
    "nameLong": "Euro / US Dollar"
  }
]
```
```

--------------------------------

### Get current quotes, historical prices, candles.

Source: https://www.dukascopy.com/trading-tools/api/documentation/quotes

This section details methods for retrieving market data including the latest minute candles, current quotes, and historical price data for trading instruments.

```APIDOC
## GET /api/lastOneMinuteCandles

### Description
Get the latest 1-minute candles for all instruments.

### Method
GET

### Endpoint
https://freeserv.dukascopy.com/2.0/?path=api/lastOneMinuteCandles

### Parameters
#### Query Parameters
- **key** (string) - Optional - Apply to get key.

### Response
#### Success Response (200)
- **array** (array) - An array of candle data.

### Response Example
```json
[
  {
    "instrument": "EURUSD",
    "time": 1678886400000,
    "open": 1.07500,
    "high": 1.07550,
    "low": 1.07450,
    "close": 1.07520,
    "volume": 1000
  }
]
```
```

```APIDOC
## GET /api/currentPrices

### Description
Get current quotes for an instrument.

### Method
GET

### Endpoint
https://freeserv.dukascopy.com/2.0/?path=api/currentPrices

### Parameters
#### Query Parameters
- **key** (string) - Optional - Apply to get key.
- **instruments** (string) - Optional - Instrument ids separated by comma.

### Response
#### Success Response (200)
- **array** (array) - An array of current price data.

### Response Example
```json
[
  {
    "instrument": "EURUSD",
    "bid": 1.07500,
    "ask": 1.07520,
    "last": 1.07510,
    "volume": 500,
    "timestamp": 1678886400000
  }
]
```
```

```APIDOC
## GET /api/historicalPrices

### Description
Get historical candles for an instrument.

### Method
GET

### Endpoint
https://freeserv.dukascopy.com/2.0/?path=api/historicalPrices

### Parameters
#### Query Parameters
- **key** (string) - Optional - Apply to get key.
- **instrument** (integer) - Required - Instrument id.
- **timeFrame** (string) - Optional - One of '1day_eet', '1day', '1hour', '10m', '1min', '10sec', 'tick'. Default is '10m'.
- **count** (integer) - Optional - Maximum number of candles to retrieve. Default is 500, max is 5000.
- **start** (integer) - Optional - Unix timestamp with milliseconds for the start of the period.
- **end** (integer) - Optional - Unix timestamp with milliseconds for the end of the period. Default is current time.
- **dayStartTime** (string) - Optional - UTC or EET day start time. Default is 'UTC'.
- **offerSide** (char) - Optional - 'B' for bid, and 'A' for ask. Default is 'B'.

### Response
#### Success Response (200)
- **array** (array) - An array of historical candle data.

### Response Example
```json
[
  {
    "instrument": "EURUSD",
    "time": 1678800000000,
    "open": 1.07000,
    "high": 1.07100,
    "low": 1.06900,
    "close": 1.07050,
    "volume": 1500
  }
]
```
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.