Find analogous moments
find_analogsFind the past moments whose price shape most resembles a given one, each with the path that followed it. Reach for this when what you hold is a moment and what you want is other moments shaped like it. If what you hold is a condition you can state, use query_history; if it is a kind of recurring event, use get_topic_outcomes; if you already have the moments and only want their paths drawn together, use get_price_paths. Matching is done by a model of ours: it reads the shape of the move before a moment rather than its level, so a quiet stretch can match a violent one and two moments thousands of dollars apart can be alike. Matches come back one by one and are never averaged; the spread between them is the answer. Each is point-in-time — what it reports was knowable at that moment, and what came after is labelled as having followed. Read the quality field before reading anything into the set. asset takes a symbol from list_coverage. at is a UTC ISO-8601 moment inside that asset's range; omit it to search from now. k is how many moments come back, and a call costs one answer for every ten of them. scale only sets the window the paths are drawn at — it does not change which moments are found. An asset kept at one value a day — list_coverage's searched says which — is matched and drawn on that one value, so the path after a moment is a bar or two rather than a curve and quality.range_median_pct comes back near zero. Read it before making anything of such a set.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| k | No | How many past moments to return. One answer per ten. | |
| at | No | UTC moment to search from, ISO 8601. Omit for now. | |
| asset | No | Asset symbol, e.g. BTC. list_coverage lists them. | BTC |
| scale | No | Window the paths are drawn at. One of 5m, 15m, 30m, 1h, 2h, 4h, 1d | 15m |