---
title: "Darkpool Time Profile"
method: GET
path: "/v1/darkpool/time-profile/{ticker}"
tags: ["darkpool"]
---

# Darkpool Time Profile

`GET /v1/darkpool/time-profile/{ticker}`

## Request

- Base URL: `https://api.optionwhales.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.optionwhales.io/v1/darkpool/time-profile/{ticker}`
- Auth: none declared

WHEN one ticker's off-exchange volume traded, by price, for one session: a sparse
5-minute × price grid of shares, per-row and per-bucket totals, the POC and 70 % value
area, and the largest block prints at their report time. A session still being built
answers 503 with ``Retry-After``.

``cells_side`` = flat [buy, sell, away] share triples in ``cells`` order: buy pressure =
shares at the ask + 60 % of those near it, sell = at the bid + 60 % near it, away = more
than 0.1 % (and 2 cents) outside the quote, left out of pressure; the rest of a cell is
neutral. ``totals`` adds ``buy_volume`` / ``sell_volume`` / ``away_volume``. Absent when
the profile was built without quotes.

## Path parameters

- `ticker` string, required

## Query parameters

- `date` string, nullable: YYYY-MM-DD; default latest

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/optionwhales/apis/optionwhales-pro-api.md) · [All operations](https://skmtc.dev/optionwhales/apis/optionwhales-pro-api/llms.txt) · [OpenAPI document](https://skmtc.dev/optionwhales/apis/optionwhales-pro-api/revisions/e76bc0d3a770?raw)