Get the historical TD Sequential (Tom DeMark Sequential) counts of a futures trading pair on an exchange, including buy counts and sell counts. Used to track trend continuation and identify potential reversal signals.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Available on these API plans: Startup Standard Professional Enterprise
Response Data
data is an array of TD counts, one record per candle; time is the candle start time in UTC milliseconds. A count may be null or omitted when it is not formed. The first four candles do not have enough comparison history. With fewer than five candles, data may be null or omitted.
Valid counts and response compatibilityValid counts are integers from 1 to 9. While the condition continues, the count stays at 9 until the direction changes or the compared closes are equal. Some responses may still contain 10–13; treat these points as unavailable and retain the raw value for investigation. Do not clamp them to 9 or interpret them as a Countdown phase. Null or missing counts are not 0.
200 · application/json · See the response example in the right panel.
| Field | Type | Always Returned | Description |
|---|---|---|---|
code | string | Yes | Business status code; "0" means success |
msg | string | No | Result message; may be omitted on success |
data | array of object or null | No | TD count array; may be null or omitted when there are fewer than five candles |
data[].time | integer (int64) | Yes | Interval start time, timestamp in milliseconds (UTC); the indicator value is calculated from candles up to and including this interval |
data[].td_buy_count | integer or null | No | TD buy count, 1–9; stays at 9 while the condition continues, until the direction changes or the compared closes are equal; null or omitted when no count is formed |
data[].td_sell_count | integer or null | No | TD sell count, 1–9; stays at 9 while the condition continues, until the direction changes or the compared closes are equal; null or omitted when no count is formed |
API Plans
Endpoint access and available intervals are listed below. See API Plans for pricing.
| API Plan | Access | Available intervals (interval) |
|---|---|---|
| Hobbyist | ❌ No | — |
| Startup | ✅ Yes | 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 1w |
| Standard | ✅ Yes | All intervals supported by this endpoint, starting at 1m |
| Professional | ✅ Yes | All intervals supported by this endpoint, starting at 1m |
| Enterprise | As agreed in your authorization | As agreed in your authorization |
Choose only values listed in this page’s interval parameter; an arbitrary value above the minimum is not necessarily supported. These restrictions concern sampling or calculation intervals, not update frequency or available history length.
The length of history you can query differs by API plan; if start_time is earlier than the range you can query, it is automatically changed to the earliest time available. For how far back each interval's history can be queried, see Intervals.
Use This Endpoint with AI
Pick a task and click Open in ChatGPT or Open in Claude: the AI reads this page first and then gives you the result. You can also click Copy and paste the full prompt into the AI tool you use.
This endpoint provides data through the REST API. Use the prompts above to have AI write the request code. For the tools available through MCP, see CoinGlass MCP.
Use Cases
| Scenario | Description |
|---|---|
| Identify Potential Reversals | When the buy or sell count approaches or reaches 9, the price has moved in the same direction for a relatively long time, and a reversal or pause may occur. |
| Track Trend Continuation | A steadily increasing count indicates that the trend is still continuing; a count that breaks off and starts over indicates that the previous rhythm has been broken. |
| Multi-Interval Confirmation | Request the 1-hour, 4-hour and daily counts separately for the same trading pair; if you only need the current values, Coin TD Sequential List returns multiple intervals for all coins in one call. |
| Strategy Backtesting | Use historical counts to backtest how rules such as “trade in the opposite direction when the count reaches 9” perform on different intervals. |
Related Endpoints
| Endpoint | How It Differs |
|---|---|
| Coin TD Sequential List | Current TD counts of all coins across multiple intervals, with the sign distinguishing buy from sell |
| Pair RSI | Uses a value from 0 to 100 to identify overbought and oversold conditions |
| Moving Average Convergence Divergence (MACD) | Gauges trend momentum and identifies golden crosses and death crosses |
| Pair Price OHLC History | Price candles for the same trading pair; can be aligned by time for comparison |
FAQ
Why do some records have only time?
No count is formed for that candle. The count fields may be null or omitted; do not replace them with 0. The first four candles lack the comparison history, and fewer than five candles may produce null or omitted data.
What is the maximum value of td_buy_count?
Valid counts are 1–9. A count stays at 9 while the condition continues and resets when the direction changes or the compared closes are equal. Treat 10–13 in an older response as unavailable, not as another stage.
What should I pass as symbol?
A trading pair, not a coin; for example, the BTC perpetual contract on Binance is BTCUSDT. Exchanges write trading pairs differently; go by what the Supported Exchanges and Pairs endpoint returns.
Why does the last record change?
The data is updated in real time. The last record corresponds to an interval that has not yet closed; its count changes with the price.
Learn More: TD Sequential
What Is TD Sequential?
This endpoint compares the current candle close with the close four candles earlier. One direction counts consecutively while the other resets; equal closes reset both. The count stays at 9 while the condition continues. The returned count fields do not represent a complete TD Sequential/Countdown algorithm or a separate trading signal.
What Does TD 9 Mean?
9 is the valid count ceiling and may repeat while the condition continues. It is not a new signal on each candle and does not guarantee a reversal.
How Do I View the TD Counts of All Coins at Once?
Use Coin TD Sequential List, which returns the current counts of all coins across multiple intervals from 1 minute to 1 week in one call; positive numbers are buy counts and negative numbers are sell counts.
