trader-entry

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

trader-entry

trader-entry

The Entry Timer turns a setup into one moment: the bar that confirms it. It reads bars, 1-minute or 5-minute, and waits for each one to finish. A price that pokes above the high in the middle of a bar is not an entry. A bar that CLOSES above it is. Then it says the time and the price, writes them down for the Exit Planner, and stops. It never buys anything. Day trading loses most people money, and a clean signal does not change that.
${CLAUDE_SKILL_DIR}
below is this skill's folder (where this SKILL.md lives).
bash
python3 "${CLAUDE_SKILL_DIR}/entry.py" check TSLA                  # 15-minute opening range, 5-minute bars
python3 "${CLAUDE_SKILL_DIR}/entry.py" check TSLA --write          # also save trader/entry.json
python3 "${CLAUDE_SKILL_DIR}/entry.py" check TSLA --setup level --level 371.20
python3 "${CLAUDE_SKILL_DIR}/entry.py" check TSLA --interval 1m --min-volume-x 1.5
python3 "${CLAUDE_SKILL_DIR}/entry.py" watch TSLA --until 15:30    # one line per closed bar, stops on the trigger
python3 "${CLAUDE_SKILL_DIR}/entry.py" watchlist                   # every hit in trader/watchlist.json
Other flags:
--or-minutes N
(default 15),
--json
,
--offline FILE
(a saved Yahoo chart JSON,
.json
or
.json.gz
, or a folder of
<TICKER>.json
),
--now "2026-10-19 10:15"
(New York time) to replay a day.
watch
with
--now
or
--offline
runs on a simulated clock and replays the day bar by bar without waiting.
Entry Timer 将一个 setup 转化为一个确定的时刻:确认 setup 的那根 bar。它读取 1 分钟或 5 分钟 bar,并等待每根 bar 结束。bar 尚在进行中时,价格短暂刺穿高点并不构成入场;只有 CLOSES 高于该价位才算。触发后,它会报告时间和价格,将其记录下来供 Exit Planner 使用,然后停止。它从不执行买入。日内交易会让大多数人亏钱,即使信号再清晰也无法改变这一点。
下面的
${CLAUDE_SKILL_DIR}
是此 skill 的文件夹(即此 SKILL.md 所在的位置)。
bash
python3 "${CLAUDE_SKILL_DIR}/entry.py" check TSLA                  # 15-minute opening range, 5-minute bars
python3 "${CLAUDE_SKILL_DIR}/entry.py" check TSLA --write          # also save trader/entry.json
python3 "${CLAUDE_SKILL_DIR}/entry.py" check TSLA --setup level --level 371.20
python3 "${CLAUDE_SKILL_DIR}/entry.py" check TSLA --interval 1m --min-volume-x 1.5
python3 "${CLAUDE_SKILL_DIR}/entry.py" watch TSLA --until 15:30    # one line per closed bar, stops on the trigger
python3 "${CLAUDE_SKILL_DIR}/entry.py" watchlist                   # every hit in trader/watchlist.json
其他 flag:
--or-minutes N
(默认 15)、
--json
、
--offline FILE
(已保存的 Yahoo chart JSON,即
.json
或
.json.gz
,或包含
<TICKER>.json
的文件夹)、
--now "2026-10-19 10:15"
(纽约时间),用于回放某一天。
watch
配合
--now
或
--offline
时,会在模拟时钟上运行,逐根回放当天的 bar,无须等待。

What it reads and writes

它读取和写入的内容

filewhat
trader/watchlist.json
the scanner's hits (
hits[].symbol
), for
watchlist
trader/config.json
no_entries_before
(09:45) and
no_entries_after
(15:30), New York time. Optional
Yahoo chart APItoday's bars,
range=1d&interval=5m
(or
1m
): free, unofficial, can lag
trader/entry.json
with
check --write
, or when
watch
triggers: symbol, setup, status, time, bar, price, level, opening range
文件用途
trader/watchlist.json
scanner 命中的标的(
hits[].symbol
),供
watchlist
使用
trader/config.json
no_entries_before
(09:45)和
no_entries_after
(15:30),均采用纽约时间。可选
Yahoo chart API当天的 bar,
range=1d&interval=5m
(或
1m
):免费、非官方,可能会滞后
trader/entry.json
使用
check --write
或
watch
触发时写入:symbol、setup、status、time、bar、price、level、opening range

The rule

规则

  • Opening range (orb). The high and low of the first 15 minutes: the 9:30, 9:35 and 9:40 five-minute bars, or fifteen 1-minute bars. The level to beat is the range high.
  • Level. A price you give, like a 20-day high from
    /trader-scanner
    .
  • The trigger is the first completed bar after the range that CLOSES above the level. A wick above is not a trigger. A close exactly at the level is not above it.
  • The time is that bar's close time (the 10:10 bar closes at 10:15 AM). The price is its close, to the cent.
  • Only closed bars count. A bar is closed when the clock passes its start plus 5 (or 1) minutes and Yahoo has caught up to that moment (it waits a minute at most). Yahoo's live tick, like 10:49:45, is never a bar.
  • Volume, if you want it.
    --min-volume-x 1.5
    also needs the trigger bar's volume at 1.5 times the range bars' average. The 9:30 bar holds the opening auction, so 1.0 is already strict.
  • Time limits. No entries before 9:45 or after 15:30 (config). On a 1:00 p.m. early close the cutoff moves up with the close, to 12:30.
  • What it says. Waiting (and how far the last close is from the level), triggered, expired, or no data. Before 9:30: not open yet. Before 9:45: the range is still forming. Weekends and NYSE holidays: the market is closed.
  • Opening range(orb)。 前 15 分钟的最高价和最低价:9:30、9:35 和 9:40 这三根 5 分钟 bar,或十五根 1 分钟 bar。需要突破的 level 是区间高点。
  • Level。 用户指定的价格,例如
    /trader-scanner
    给出的 20 日高点。
  • Trigger 是区间形成后第一根 CLOSES 高于 level 的已完成 bar。仅有上影线刺穿不算 trigger。收盘价恰好等于 level 也不算高于它。
  • 时间是该 bar 的收盘时间(10:10 bar 于上午 10:15 收盘)。价格是其收盘价,精确到美分。
  • 只计算已收盘的 bar。 当时钟超过 bar 的开始时间 5 分钟(或 1 分钟),并且 Yahoo 数据已更新至该时刻时,该 bar 才算已收盘(最多等待一分钟)。Yahoo 的实时 tick(如 10:49:45)永远不算 bar。
  • Volume(可选)。
    --min-volume-x 1.5
    还要求 trigger bar 的成交量达到区间内各 bar 平均成交量的 1.5 倍。9:30 bar 包含开盘集合竞价,因此 1.0 倍已经算严格。
  • 时间限制。 9:45 前或 15:30 后不发出入场信号(可配置)。若市场在下午 1:00 提前收盘,截止时间也会相应提前至 12:30。
  • 它会报告什么。 等待中(并显示最近收盘价距 level 还有多远)、已触发、已过期或无数据。9:30 前:尚未开盘。9:45 前:区间仍在形成。周末和 NYSE 节假日:市场休市。

Steps

步骤

  1. Get the symbol from the user, or run
    entry.py watchlist
    after
    /trader-scanner
    . Check
    /trader-news
    for it first.
  2. Run
    entry.py check SYMBOL
    . Tell the user the status in one line: waiting and how far, triggered at what time and price, or expired.
  3. To wait for it, Claude can run
    entry.py watch SYMBOL --until 15:30
    in the background, or
    entry.py check SYMBOL --write
    on a
    /loop
    every 5 minutes.
    watch
    wakes just after each bar closes, prints one line per bar, and exits 0 on the trigger (it writes
    trader/entry.json
    ) or 1 when the setup expires. Keep the computer awake while it watches: a sleeping laptop pauses it, and it catches up, late, when it wakes.
  4. When it triggers, say the time and the price, and that nothing was placed. If the trigger is more than a bar old, say that too: a late entry is a different trade.
  5. Hand off to
    /trader-exit
    to set the stop and the target BEFORE anything is bought.
  1. 从用户处获取 symbol,或在运行
    /trader-scanner
    后执行
    entry.py watchlist
    。先为该标的检查
    /trader-news
    。
  2. 运行
    entry.py check SYMBOL
    。用一行向用户说明状态:正在等待及距离目标还有多远、已在何时以何价格触发,或已过期。
  3. 如需持续等待,Claude 可以在后台运行
    entry.py watch SYMBOL --until 15:30
    ,也可以在
    /loop
    中每 5 分钟运行一次
    entry.py check SYMBOL --write
    。
    watch
    会在每根 bar 刚收盘后唤醒,每根 bar 输出一行;触发时退出码为 0(并写入
    trader/entry.json
    ),setup 过期时退出码为 1。监视期间请保持电脑唤醒:笔记本进入睡眠后监视会暂停,唤醒后才会延迟补上。
  4. 触发时,说明时间和价格,并说明没有执行任何下单。如果触发信号已超过一根 bar 的时间,也应告知用户:延迟入场是另一笔交易。
  5. 在买入任何标的之前,将任务移交给
    /trader-exit
    ,先设置止损和目标。

Example: the reel

示例:实战回放

TSLA, Monday 2026-10-19, 5-minute bars. The opening range is 354.47 to 362.18. At 10:12 the 10:10 bar is still open, so it waits:
WAITING  last close $361.68 (10:05 bar), $0.50 under the range high $362.18 (-0.14%).
The 10:10 bar is still forming ($364.18 so far, closes 10:15 AM); it does not count until it closes.
At 10:15 the bar has closed:
TSLA  Mon 2026-10-19 10:15 ET  opening-range breakout (15-minute range) on 5-minute bars (Yahoo, free, can lag)
Opening range 9:30-9:45: high $362.18, low $354.47 (3 of 3 bars).
TRIGGERED 10:15 AM at $364.18: the 10:10 bar (bar 8) closed above the range high $362.18 (+0.55%).
This is the moment to get in, if you take the trade. Nothing was placed.
Next: set the stop and target BEFORE you buy: /trader-exit (exit.py plan --from trader/entry.json).
With
--min-volume-x 1
the 10:10 bar is too thin (0.60x the range's volume) and the trigger moves to 10:35 AM at 365.75 (the 10:30 bar, 7.98x).
TSLA,2026-10-19 星期一,使用 5 分钟 bar。opening range 为 354.47 至 362.18。10:12 时,10:10 bar 仍在形成,因此继续等待:
WAITING  last close $361.68 (10:05 bar), $0.50 under the range high $362.18 (-0.14%).
The 10:10 bar is still forming ($364.18 so far, closes 10:15 AM); it does not count until it closes.
10:15 时,该 bar 已经收盘:
TSLA  Mon 2026-10-19 10:15 ET  opening-range breakout (15-minute range) on 5-minute bars (Yahoo, free, can lag)
Opening range 9:30-9:45: high $362.18, low $354.47 (3 of 3 bars).
TRIGGERED 10:15 AM at $364.18: the 10:10 bar (bar 8) closed above the range high $362.18 (+0.55%).
This is the moment to get in, if you take the trade. Nothing was placed.
Next: set the stop and target BEFORE you buy: /trader-exit (exit.py plan --from trader/entry.json).
使用
--min-volume-x 1
时,10:10 bar 的成交量过少(为区间成交量的 0.60 倍),因此 trigger 会推迟至上午 10:35,价格为 365.75(10:30 bar,7.98 倍)。

Rules

规则

  • Bar by bar, on free Yahoo 1-minute or 5-minute bars. They are unofficial and can lag. Say so when a minute matters.
  • A signal is information, not an order, and not a promise. Nothing here promises winning trades or money.
  • Long side only. v2 plans longs only. If the user wants a short, say that.
  • One trigger per setup per day: the first close above. Later closes do not reset it.
  • Never call an entry early because a bar looks like it will close above.
  • 逐根处理免费的 Yahoo 1 分钟或 5 分钟 bar。数据并非官方提供,可能会滞后;当具体到某一分钟时必须说明这一点。
  • 信号只是信息,不是订单,也不是承诺。这里的任何内容都不承诺盈利交易或收益。
  • 仅支持 long side。v2 仅规划多头交易。如果用户想做空,就说明这一点。
  • 每个 setup 每天只能触发一次:第一次收盘高于 level 时触发。之后的收盘不会重置触发状态。
  • 不要因为某根 bar 看起来将收于 level 上方,就提前发出入场信号。

What it never does

它绝不会做什么

It never places an order, never sizes a position, never sets the stop (that is
/trader-exit
), never moves the level after the fact, and never counts a bar that has not closed. It never runs
/trader-broker
from a background watch: nobody is there to say yes.
它从不下单,从不计算仓位规模,从不设置止损(这是
/trader-exit
的职责),从不事后调整 level,也从不计算尚未收盘的 bar。它绝不会在后台 watch 过程中运行
/trader-broker
:届时没有人能够确认操作。

Safety

安全

  • Education and tooling, not financial advice. A PASS is a rules check, not a recommendation.
  • Paper trading by default (
    "paper": true
    ). Going live is the user's own decision, in their own config.
  • Nothing in this pack places an order except trader-broker, and only when all three hold: trader-risk passed that exact order today, the user typed an explicit yes for that one order in the chat, and the user clicked Allow once on Claude's own card because the order tool is set to "Needs approval" (Customize > Connectors > tool permissions). Never set an order tool to "Always allow".
  • No options, margin, short selling or leverage unless the config allows it and the user confirms.
  • Broker keys live in environment variables or the Claude Desktop config, never in the chat.
  • 本工具用于教育和辅助,不构成财务建议。PASS 仅表示规则检查通过,并不代表推荐。
  • 默认使用 paper trading(
    "paper": true
    )。是否转为 live 由用户自行决定,并在其自己的配置中设置。
  • 这套工具中,只有 trader-broker 会下单,而且必须同时满足以下三个条件:trader-risk 已于当天批准该笔具体订单;用户在聊天中针对该笔订单明确输入 yes;由于 order tool 被设置为“Needs approval”,用户还必须在 Claude 自己的卡片上点击一次 Allow(Customize > Connectors > tool permissions)。绝不要将 order tool 设置为“Always allow”。
  • 除非配置允许且用户确认,否则不得使用 options、margin、short selling 或 leverage。
  • Broker 密钥只能存放在环境变量或 Claude Desktop 配置中,绝不能出现在聊天中。