---
title: "GET /futures/v1/trades/{ticker}"
method: GET
path: "/futures/v1/trades/{ticker}"
tags: ["us_futures"]
---

# GET /futures/v1/trades/{ticker}

`GET /futures/v1/trades/{ticker}`

Retrieve comprehensive, tick-level trade data for a specified futures contract ticker over a defined time range. Each record includes the trade price, size, session start date, and precise timestamps, capturing individual trade events throughout the period. This granular data is essential for constructing aggregated bars and performing detailed analyses of intraday price movements, making it a valuable tool for backtesting, algorithmic strategy development, and market research.

Use Cases: Intraday analysis, algorithmic trading, backtesting, market research.

## Path parameters

- `ticker` string, required

## Query parameters

- `timestamp` string
- `timestamp.gt` string
- `timestamp.gte` string
- `timestamp.lt` string
- `timestamp.lte` string
- `session_end_date` string
- `limit` integer
- `sort` string

## Response `200`

A list of results.

- object
  - `next_url` string — If present, this value can be used to fetch the next page.
  - `request_id` string, required — A request id assigned by the server.
  - `results` object[], required — The results for this request.
    - `channel` integer, required — The CME multicast channel this event was sourced from.
    - `price` number, double — The price of the trade. This is the actual dollar value per whole contract of this trade. A trade of 100 contracts with a price of $2.00 would be worth a total dollar value of $200.00.
    - `report_sequence` integer, required — The reporting sequence number.
    - `sequence_number` integer, required — The unique sequence number assigned to this trade.
    - `session_end_date` string — Also known as the trading date, the date of the end of the trading session, in YYYY-MM-DD format.
    - `size` integer — The total number of contracts exchanged between buyers and sellers on a given trade.
    - `ticker` string, required — The futures contract identifier, including the base symbol and contract expiration (e.g., GCJ5 for the April 2025 gold contract).
    - `timestamp` integer, required — The time when the trade was generated at the exchange to nanosecond precision.
  - `status` 'OK', required — The status of this request's response.

## Other responses

- `400` — An error message.

---

[API](https://skmtc.net/massive/apis/polygon-api.md) · [All operations](https://skmtc.net/massive/apis/polygon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/massive/polygon-api/revisions/ad6f143e43aa/schema)