---
title: "Ticker Darkpool Trades"
method: GET
path: "/api/darkpool/{ticker}"
---

# Ticker Darkpool Trades

`GET /api/darkpool/{ticker}`

-> Returns the darkpool trades for the given ticker on a given day. Date must be the current or a past date. If no date is given, returns data for the current/last market day.

## Path parameters

- `ticker` string, required

## Query parameters

- `date` string, date
- `limit` integer
- `newer_than` string
- `older_than` string

## Response `200`

Successful response

- DarkpoolTradesResponse
  - `data` DarkpoolTrade[]
    - `canceled` boolean — Whether the trade has been cancelled.
    - `executed_at` string, date-time — The time with timezone when a trade was executed.
    - `ext_hour_sold_codes` 'sold_out_of_sequence' | 'extended_hours_trade_late_or_out_of_sequence' | 'extended_hours_trade' — The code describing why the trade happened outside of regular market hours. Null if none applies.
    - `market_center` string — The market center code.
    - `nbbo_ask` string — The National Best Bid and Offer ask price.
    - `nbbo_ask_quantity` integer — The quantity for the NBBO ask.
    - `nbbo_bid` string — The National Best Bid and Offer bid price.
    - `nbbo_bid_quantity` integer — The quantity for the NBBO bid.
    - `premium` string — The total option premium.
    - `price` string — The price of the trade.
    - `sale_cond_codes` 'contingent_trade' | 'odd_lot_execution' | 'prio_reference_price' | 'average_price_trade' — The sale condition code. Null if none applies.
    - `size` integer — The size of the transaction.
    - `ticker` string — The stock ticker.
    - `tracking_id` integer — The tracking ID of the trade.
    - `trade_code` 'derivative_priced' | 'qualified_contingent_trade' | 'intermarket_sweep' — The trade code. Null if none applies.
    - `trade_settlement` 'cash_settlement' | 'next_day_settlement' | 'seller_settlement' | 'regular_settlement' — The kind of trade settlement.
    - `volume` integer — The volume of the ticker for the trading day.

## Other responses

- `400` — Invalid request
- `401` — Unauthorized

---

[API](https://skmtc.net/the-unnatural-group--llc/apis/tradesignals-api.md) · [All operations](https://skmtc.net/the-unnatural-group--llc/apis/tradesignals-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/the-unnatural-group--llc/tradesignals-api/versions/0b37cadfb125/schema)