# Get mark price candle data

```
/api/v1/kline/mark
```

#### Query Parameters

<table><thead><tr><th width="176">Field</th><th width="98">Type</th><th width="95">Need</th><th width="189">Description</th><th>Example</th></tr></thead><tbody><tr><td><code>"symbol"</code></td><td>string</td><td>required</td><td>Trading pair symbol</td><td><code>BTC</code></td></tr><tr><td><code>"interval"</code></td><td>string</td><td>required</td><td>Candlestick interval<br>Valid values: 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 8h, 12h, 1d</td><td><code>1m</code></td></tr><tr><td><code>"start_time"</code></td><td>integer</td><td>required</td><td>Start time in milliseconds</td><td><code>1716200000000</code></td></tr><tr><td><code>"end_time"</code></td><td>integer</td><td>optional</td><td>End time in milliseconds, defaults to current time if not provided</td><td><code>1742243220000</code></td></tr></tbody></table>

```
/api/v1/kline/mark?symbol=BTC&interval=1m&start_time=1742243160000&end_time=1742243220000
```

#### Response

* Status 200: Successfully retrieved mark price candle data

```json
{
  "success": true,
  "data": [
    {
      "t": 1764126720000,
      "T": 1764126780000,
      "s": "BTC",
      "i": "1m",
      "o": "87701",
      "c": "87687.303362",
      "h": "87739",
      "l": "87687.303362",
      "v": "0.84106",
      "n": 62
    },
    {
      "t": 1764126780000,
      "T": 1764126840000,
      "s": "BTC",
      "i": "1m",
      "o": "87684.118667",
      "c": "87654",
      "h": "87684.118667",
      "l": "87645",
      "v": "4.5997",
      "n": 91
    }
  ],
  "error": null,
  "code": null
}
```

| Field | Type           | Description                                     |
| ----- | -------------- | ----------------------------------------------- |
| `'t'` | number         | Candle start time                               |
| `'T'` | number         | Candle end time                                 |
| `'s'` | string         | Symbol                                          |
| `'i'` | string         | Time interval of candles                        |
| `'o'` | decimal string | Open price                                      |
| `'c'` | decimal string | Close price                                     |
| `'h'` | decimal string | High price                                      |
| `'l'` | decimal string | Low price                                       |
| `'v'` | decimal string | Volume (always `"0"`)                           |
| `'n'` | number         | Number of trades on Pacifica in candle duration |

* Status 400: Invalid request parameters
* Status 401: Unauthorized access
* Status 500: Internal server error

#### Code Example (Python)

```python
import requests

response = requests.get(
    "/api/v1/kline/mark?symbol=BTC&interval=1m&start_time=1742243160000&end_time=1742243220000",
    headers={"Accept": "*/*"},
)

data = response.json()
```