gpu watch get

Get a watch rule

Synopsis

Shows one watch rule: what it targets, what it alerts on, where the market is right now, where its alerts are delivered, and whether it has fired.

State folds two facts into one line, because they answer the same question — will this rule alert me?

• armed — the condition is currently false, so the next time it becomes true you get an alert.
• fired — the condition is true and has already alerted. The rule re-arms once the condition has cleared, that clear has held for five minutes, and the quiet window has passed — 6 hours for stock rules, 4 hours for price rules. A rule can therefore sit in fired for hours quite normally.
• disabled — the rule is stored but not evaluated. When a reason is shown in parentheses (for example, the creator left the organization) that is why: a rule whose creator is gone stops rather than continuing to mail an address nobody reads. Turning such a rule back on with gpu watch update is re-checked first and can be refused — that page explains the two refusals and which one is worth retrying.

Current reads the same way it does on gpu watch list: on-demand availability only, with sold out and — meaning different things.

Delivery names an endpoint id, never a URL. A watch rule cannot hold a destination address — per-rule routing is a reference to an endpoint you already registered with gpu webhooks create.

The output ends with a pointer to gpu autolaunch create. That is the intended path from "tell me when this happens" to "do this when it happens", and it is deliberately a different command creating a different object: an auto-launch spends money, so it asks for a spend ceiling and freezes its launch spec at the moment you approve it. No flag on gpu watch converts a rule into one.

A rule belonging to another organization reports not found — the same answer as a rule id that does not exist anywhere.

gpu watch get <rule-id> [flags]

Examples

# Rule ids are UUIDs, as printed by `gpu watch list`
gpu watch get 8b1f0c4e-2a55-4f13-9d84-6c2b7e0a3f91

# Machine-readable form, including the current market reading
gpu watch get 8b1f0c4e-2a55-4f13-9d84-6c2b7e0a3f91 -o json

Options

  -h, --help   help for get

Options inherited from parent commands

      --api-base string   API base URL (override with GPUAI_API_BASE env) (default "https://api.gpu.ai/v1")
      --debug             Enable debug logging to stderr
  -o, --output string     Output format: table|json (default table on TTY, json otherwise)

SEE ALSO

• gpu watch - Watch GPU price and availability, and get alerted when it moves