---
title: "Get previous trades in time buckets."
method: GET
path: "/trade/bucketed"
tags: ["Trade"]
---

# Get previous trades in time buckets.

`GET /trade/bucketed`

Timestamps returned by our bucketed endpoints are the **end** of the period, indicating when the bucket was written to disk. Some other common systems use the timestamp as the beginning of the period. Please be aware of this when using this endpoint.

Also note the `open` price is equal to the `close` price of the previous timeframe bucket.

## Query parameters

- `binSize` string
- `partial` boolean
- `symbol` string
- `filter` string, JSON
- `columns` string, JSON
- `count` integer
- `start` integer
- `reverse` boolean
- `startTime` string, date-time
- `endTime` string, date-time

## Response `200`

Request was successful

- TradeBin[]
  - `timestamp` string, date-time, required
  - `symbol` string, required
  - `open` number, double
  - `high` number, double
  - `low` number, double
  - `close` number, double
  - `trades` integer
  - `volume` integer
  - `vwap` number, double
  - `lastSize` integer
  - `turnover` integer
  - `homeNotional` number, double
  - `foreignNotional` number, double

## Other responses

- `400` — Parameter Error
- `401` — Unauthorized
- `403` — Access Denied
- `404` — Not Found

## Changes

- **2019-12-18** `fd2de3a82a03` — 1 info
  - added the non-success response with the status `403`
- **2018-05-30** `0c1c991454e3` — 1 info
  - removed the non-success response with the status `403`

[Change history](https://skmtc.dev/bitmex/apis/bitmex-api/changes/trade/bucketed/get.md)

---

[API](https://skmtc.dev/bitmex/apis/bitmex-api.md) · [All operations](https://skmtc.dev/bitmex/apis/bitmex-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bitmex/bitmex-api/revisions/04c6a16ffd27/schema)