Objects
Setup
One current pattern on a ticker: the lines to draw, the trigger, stop and target, and the track record behind them.
One current pattern on a ticker: the lines to draw, the trigger, stop and target, and the track record behind them. Everything is read from the last nightly run; nothing is computed per request.
Fields
| Field | Type | Description |
|---|---|---|
setup_id | string | Identifier of this pattern occurrence in the current nightly book. Pass it as setup_id to the chart.png route. It is stable while the setup stays current and is not valid across nights, so re-read the patterns when the chart route answers setup_not_found. |
lineage_id | string · nullable | Key of the candidate lineage this occurrence belongs to, shared by the revisions of the same detected pattern. Null when the stored candidate carries none. |
page_url | string · nullable | Link that opens this setup on the TradingPal site: the Screener quick view, focused on the ticker, naming this exact setup. Free to read. Give it to the user when the chat app cannot show the chart image. |
symbol | string | Exchange symbol, upper case. |
interval | string | Bar interval. Always D: daily bars. Always D. |
family | string (enum) | The display family of the pattern, one of rising_wedge, falling_wedge, bullish_pennant, bearish_pennant, triangle. One of rising_wedge, falling_wedge, bullish_pennant, bearish_pennant, triangle. |
family_label | string | Human-readable family name, for example "Falling wedge". |
pattern_type | string · nullable | The detector's own pattern type, which can be more specific than family (for example a triangle subtype). Null when the artifact carries none. |
direction | string (enum) · nullable | The side the pattern is expected to resolve to: bullish or bearish. Null when the pattern has no single direction, such as a symmetrical triangle that carries a plan for each side. One of bullish, bearish. |
status | string | Lifecycle stage of the setup: forming until the trigger rule fires, in_progress once a daily close has triggered it (entered is then present). Defaults to forming when the artifact stores no stage. |
pattern_start | date · nullable | Session date of the first bar of the pattern, as an ISO date. Null when unknown. |
pattern_end | date · nullable | Session date of the last bar of the detected pattern, as an ISO date; the lines run on past it to the last session. Null when unknown. |
as_of_session | date · nullable | The session this setup is valid for, as an ISO date; the same value as the envelope's as_of_session. |
last_close | number · nullable | The close of the last session before as_of_session, in dollars, so a caller can place the trigger relative to price without another quote; every route reports the same value for the same setup. Null when no price is stored. |
price_scale | string | Always log: the lines are straight in log price, so draw them on a log-scale price axis. Always log. |
lines | object | The two boundary lines of the pattern. |
lines.upper | object · nullable | The upper boundary. Bullish plans trigger on a daily close above it. Null when the stored pattern has no upper line. |
lines.upper.start | object | The earlier endpoint: the session and price where the line begins. |
lines.upper.start.date | date | Session date of the bar, as an ISO date. |
lines.upper.start.price | number | Price in dollars, rounded to four decimals. |
lines.upper.end | object | The later endpoint, at the end of the pattern geometry. The trigger price sits on the extension of the line past this point. |
lines.upper.end.date | date | Session date of the bar, as an ISO date. |
lines.upper.end.price | number | Price in dollars, rounded to four decimals. |
lines.upper.touch_count | integer · nullable | How many bars touched the line, as the detector counted them; the length of touches when no count is stored. |
lines.upper.touches | array of object | The bars that touched the line, in the order the detector recorded them, so a charting tool can reproduce the fit. May be empty. |
lines.upper.touches[].date | date | Session date of the touching bar, as an ISO date. |
lines.upper.touches[].price | number · nullable | The bar high (upper line) or low (lower line) in dollars. Null when that bar is not in the stored candle tail. |
lines.lower | object · nullable | The lower boundary. Bearish plans trigger on a daily close below it. Null when the stored pattern has no lower line. |
lines.lower.start | object | The earlier endpoint: the session and price where the line begins. |
lines.lower.start.date | date | Session date of the bar, as an ISO date. |
lines.lower.start.price | number | Price in dollars, rounded to four decimals. |
lines.lower.end | object | The later endpoint, at the end of the pattern geometry. The trigger price sits on the extension of the line past this point. |
lines.lower.end.date | date | Session date of the bar, as an ISO date. |
lines.lower.end.price | number | Price in dollars, rounded to four decimals. |
lines.lower.touch_count | integer · nullable | How many bars touched the line, as the detector counted them; the length of touches when no count is stored. |
lines.lower.touches | array of object | The bars that touched the line, in the order the detector recorded them, so a charting tool can reproduce the fit. May be empty. |
lines.lower.touches[].date | date | Session date of the touching bar, as an ISO date. |
lines.lower.touches[].price | number · nullable | The bar high (upper line) or low (lower line) in dollars. Null when that bar is not in the stored candle tail. |
trigger_rule | string · nullable | The trigger rule in one sentence, chosen by direction: a daily close above the upper line, below the lower line, or through either line when the pattern carries a plan per side. Always present. |
edge_filter | object · nullable | The setup's Edge Filter tier and night rank: its best order's, the tier its card shows; each plan carries its own. The TradingPal Edge Filter's grade from the night's run, as the card's tier ribbon shows it. Null when the night did not grade it. |
edge_filter.tier | string (enum) · nullable | S, A, B, C, or F (refused). Null only when locked. One of S, A, B, C, F. |
edge_filter.rank | integer · nullable | The place among the night's graded orders the Edge Filter keeps, 1 = best (S with rank 3 reads S3). Null on F. |
edge_filter.refused | boolean · nullable | True on F: the Edge Filter and Autopilot skip it. Null when locked. |
edge_filter.reason | string · nullable | Why the grade refused it, when it said (for example similar_trades_floor, or short: every short is F). Null otherwise. |
edge_filter.session | date · nullable | The session the grade is for, as an ISO date. |
edge_filter.locked | boolean | True for a reader without Premium (the keyless demo): the tier is served as null. |
plans | array of object | One trade plan per direction the pattern can resolve in: usually one, two for a symmetrical triangle. Empty when the stored candidate has no eligible branch. |
plans[].direction | string (enum) | The side this plan trades: bullish (a close above the upper line) or bearish (a close below the lower line). One of bullish, bearish. |
plans[].trigger_price | number · nullable | The daily close that confirms the pattern, in dollars, as of the last session. It sits on the boundary line, so it moves a little each session. Null when the stored branch has none. |
plans[].stop_price | number · nullable | The stop level in dollars. The backtest freezes it at entry and fills it on a touch, or at the open after an adverse gap. Null when the stored branch has none. |
plans[].target_price | number · nullable | The measured-move target in dollars: the pattern height projected from the trigger. Null when the stored branch has none. |
plans[].edge_filter | object · nullable | This order's own Edge Filter tier and night rank. The TradingPal Edge Filter's grade from the night's run, as the card's tier ribbon shows it. Null when the night did not grade it. |
plans[].edge_filter.tier | string (enum) · nullable | S, A, B, C, or F (refused). Null only when locked. One of S, A, B, C, F. |
plans[].edge_filter.rank | integer · nullable | The place among the night's graded orders the Edge Filter keeps, 1 = best (S with rank 3 reads S3). Null on F. |
plans[].edge_filter.refused | boolean · nullable | True on F: the Edge Filter and Autopilot skip it. Null when locked. |
plans[].edge_filter.reason | string · nullable | Why the grade refused it, when it said (for example similar_trades_floor, or short: every short is F). Null otherwise. |
plans[].edge_filter.session | date · nullable | The session the grade is for, as an ISO date. |
plans[].edge_filter.locked | boolean | True for a reader without Premium (the keyless demo): the tier is served as null. |
plans[].estimates | object · nullable | The TradingPal model's estimates for this order, as the setup card shows them, from the night it was graded. Null when the grade gave the order none (a sell, or an order the grade does not hold). Quote them as estimates, under their labels. |
plans[].estimates.win_chance_pct | number · nullable | Win chance: the estimated chance the trade wins, as a percent. |
plans[].estimates.avg_return_pct | number · nullable | Est. avg return: the estimated average return per trade, net %, over wins and losses. |
plans[].estimates.est_win_pct | number · nullable | Est. win: the estimated median winning move from the trigger, as a percent; target_price is this move from the trigger. |
plans[].estimates.labels | object | The site's label for each number. |
plans[].estimates.locked | array of string | The estimates served as null because the reader is not on Premium (the keyless demo). |
plans[].estimates.summary | string · nullable | The estimates in one sentence, under their labels. |
plans[].estimates.source | string | How the estimates are made, in one sentence. |
plans[].similar_trades | SimilarRecord | The record of the earlier look-alike trades for this order, as the site's Similar trades panel states it. Null when the evening search holds no answer for the order (it is rebuilt each evening). |
track_record | object | The backtest records behind this setup, at family scope and at ticker scope. |
track_record.family | Track record | The family's record over the served universe. Null when no record is sealed for the family. |
track_record.ticker | Track record | The record of this family on this ticker. Null when the ticker has no resolved history for the family, or too few trades to display. |
entered | object | The fill, present only once the trigger has fired (status in_progress). Absent while forming. |
entered.entry_date | date · nullable | Session date of the bar that triggered the setup, as an ISO date. Null when the artifact stores no entry time. |
entered.entry_price | number · nullable | The entry price in dollars, recorded when the trigger fired. |
entered.stop_price | number · nullable | The stop in dollars, frozen at entry. |
entered.target_price | number · nullable | The target in dollars, fixed at entry. |
Example
{
"setup_id": "NVDA:D:falling_wedge:1",
"lineage_id": "lineage-1",
"page_url": "https://www.tradingpal.io/screener/falling-wedge?interval=D&focus=NVDA&p=aB3",
"symbol": "NVDA",
"interval": "D",
"family": "falling_wedge",
"family_label": "Falling wedge",
"pattern_type": "falling_wedge",
"direction": "bullish",
"status": "forming",
"pattern_start": "2026-08-08",
"pattern_end": "2026-09-07",
"as_of_session": "2026-09-25",
"last_close": 101.5,
"price_scale": "log",
"lines": {
"upper": {
"start": {
"date": "2026-08-08",
"price": 110
},
"end": {
"date": "2026-09-07",
"price": 104
},
"touch_count": 3,
"touches": [
{
"date": "2026-08-08",
"price": 111.2
}
]
},
"lower": {
"start": {
"date": "2026-08-08",
"price": 90
},
"end": {
"date": "2026-09-07",
"price": 98
},
"touch_count": 2,
"touches": []
}
},
"trigger_rule": "A daily close above the upper line; the trigger price moves with the line.",
"edge_filter": {
"tier": "S",
"rank": 3,
"refused": false,
"reason": null,
"session": "2026-09-25",
"locked": false
},
"plans": [
{
"direction": "bullish",
"trigger_price": 105.25,
"stop_price": 96,
"target_price": 120,
"edge_filter": {
"tier": "S",
"rank": 3,
"refused": false,
"reason": null,
"session": "2026-09-25",
"locked": false
}
}
],
"track_record": {
"family": {
"scope": "family",
"family": "falling_wedge",
"symbol": null,
"win_rate_pct": 54,
"sample_size": 1287,
"wins": 695,
"losses": 592,
"avg_win_pct": 8.1,
"avg_loss_pct": -4.2,
"median_win_pct": 6.3,
"avg_trade_pct": 2.4,
"avg_r": 0.41,
"expected_r": 0.41,
"profit_factor": 1.61,
"avg_hold_bars": 11.2,
"backtest_range": [
"2006-09-25",
"2026-09-25"
],
"measured": "Every detector-confirmed breakout … open trades are excluded.",
"summary": "Falling wedge: 1,287 resolved trades from 2006-09-25 to 2026-09-25; 54% reached the target, average win +8.1%, average loss -4.2%, median win +6.3%."
},
"ticker": null
}
}