---
title: "Get Spot Trades"
method: GET
path: "/v2/spot/trades"
tags: ["v2 - Spot"]
---

# Get Spot Trades

`GET /v2/spot/trades`

Get historical spot aggregated trade data with pagination. Timestamps accept millisecond epoch or ISO8601 format.

<Info>Learn how to query effectively using time filters and pagination limits in our [Fetching Data & Pagination](/fetching-data) guide.</Info>

<Info>Check the [Available Data & Markets](/available-data) guide to see which market types are supported for each coin.</Info>

## Query parameters

- `coin` string, required
- `start_time` string
- `end_time` string
- `limit` integer
- `offset` integer

## Response `200`

Successful Response

- PaginatedTrades
  - `trades` Trade[], required
    - `id` integer, required
    - `price_open` number, required
    - `price_high` number, required
    - `price_low` number, required
    - `price_close` number, required
    - `total_volume` number, required
    - `aggressive_buy_volume` number, required
    - `aggressive_sell_volume` number, required
    - `num_trades` integer, required
    - `timestamp` string, required — Source timestamp from Binance (ISO8601)
  - `total` integer, required — Total number of matching trades
  - `limit` integer, required — Results per page
  - `offset` integer, required — Current pagination offset

## Other responses

- `422` — Validation Error

---

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