---
title: "Retrieves historical bars based on the specified request parameters."
method: POST
path: "/api/History/retrieveBars"
tags: ["History"]
---

# Retrieves historical bars based on the specified request parameters.

`POST /api/History/retrieveBars`

## Request body

- RetrieveBarRequest
  - `contractId` string, required
  - `live` boolean, required
  - `startTime` string, date-time, required
  - `endTime` string, date-time, required
  - `unit` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7, required — 0 = Unspecified 1 = Second 2 = Minute 3 = Hour 4 = Day 5 = Week 6 = Month 7 = Tick
  - `unitNumber` integer, required
  - `limit` integer, required
  - `includePartialBar` boolean, required

## Response `200`

The response with the retrieved bars.

- RetrieveBarResponse
  - `success` boolean, required
  - `errorCode` 0 | 1 | 2 | 3 | 4, required — 0 = Success 1 = ContractNotFound 2 = UnitInvalid 3 = UnitNumberInvalid 4 = LimitInvalid
  - `errorMessage` string
  - `bars` AggregateBarModel[]
    - `t` string, date-time, required
    - `o` number, required
    - `h` number, required
    - `l` number, required
    - `c` number, required
    - `v` integer, required
    - `d` string, date
    - `k` integer

---

[API](https://skmtc.dev/topstepx/apis/projectx-gateway-api.md) · [All operations](https://skmtc.dev/topstepx/apis/projectx-gateway-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/topstepx/projectx-gateway-api/revisions/688252f4f704/schema)