{"uid":"cap_mRZi2Tqs1vlj4CpcCt8cU","slug":"hypernatt-similarity-match-fdd9e950","name":"HYPERNATT Similarity Match","description":"Pay $0.001 USDC to access: HyperNatt BTC historical microstructure similarity TOP3 with observed outcomes (read-only)","url":"https://hypernatt.com/api/m2m/similarity-match","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"full":{"type":"string","description":"Set to 'true' for the full match payload"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"full":"true"}}},"response":{"pair":"BTC/USDC","symbol":"BTCUSDT","matches":[{"rank":1,"context_en":"High cosine (99.7%) vs current microstructure; BTC moved +0.02% over ~4h after match.","matched_at":"2026-06-14 04:30","price_then":64470,"outcome_4h_pct":0.02,"similarity_pct":99.7},{"rank":2,"context_en":"High cosine (99.7%) vs current microstructure; BTC moved -0.09% over ~4h after match.","matched_at":"2026-06-14 04:15","price_then":64498.38,"outcome_4h_pct":-0.09,"similarity_pct":99.7},{"rank":3,"context_en":"High cosine (99.7%) vs current microstructure; BTC moved +0% over ~4h after match.","matched_at":"2026-06-13 22:49","price_then":64508.77,"outcome_4h_pct":0,"similarity_pct":99.7}],"product":"hypernatt_similarity_match_v1","issued_at":"2026-06-17T21:45:39.628Z","disclaimer":"Read-only historical analogy from HyperNatt live snapshots. Not financial or trade advice.","limitations":["Similarity is cosine on 7 microstructure features (F#24 raw + magnet), not price pattern matching.","outcome_4h_pct is BTC price change from liq_radar snapshot timeline, not trade outcomes.","Candidates within the last 24 hours are excluded by design.","liq_density clusters are model estimates, not exchange-reported liquidations.","Agents must follow interpretation_contract_v1; never upgrade confidence_tier in natural language."],"methodology":{"algorithm":"cosine_similarity_top3","source_file":"liq_radar_snapshots.jsonl","parity_module":"trading/f26_live_rnd.py::compute_top3_cosine_matches","exclusion_window_hours":24},"corpus_stats":{"days_span":43.9,"snapshot_count":2169,"last_snapshot_at":"2026-06-17T21:45:04.720965Z","first_snapshot_at":"2026-05-05T00:46:28.686317Z","eligible_candidates":2073,"exclusion_window_hours":24},"vault_wallet":"0x04e2eb302fe9ff23a9d1f2455084af624737a6d8","current_regime":{"f21_bias":"BEARISH_MAGNET","f21_score":-45,"long_trap_phase":4,"price_at_compute":64202},"data_available":true,"confidence_tier":"low","agent_reading_en":"confidence_tier=low: Matches are clustered (same day and/or identical similarity scores); analogy is illustrative, not multi-sample confirmation. TOP matches share the same similarity_pct; microstructure snapshots are nearly identical — avoid stacking them as separate evidence. Observed ~4h BTC moves on listed matches average -0.02% (spot, not vault). This is read-only microstructure analogy — not a trade signal.","episode_diversity":{"match_count":3,"cluster_warning_en":"TOP matches share the same similarity_pct; microstructure snapshots are nearly identical — avoid stacking them as separate evidence.","same_similarity_score":true,"similarity_spread_pct":0,"independent_calendar_days":2},"feature_vector_live":[63,-0.000026,0.9789,-3.81,0.7,0,-45],"feature_vector_labels":["ls_long_pct","funding_rate","taker_ratio","oi_delta_pct","hlp_btc_signed","reserved","f21_score"],"interpretation_contract_v1":{"version":"1","not_for_en":["Vault entry/exit or leg management (use get_btc_usdc_signal).","Live MM trap / sweep verdict (use get_mm_trap_state).","Probability of profit or trade sizing."],"purpose_en":"Historical analogy only: when BTC microstructure resembled the current feature vector, what was the observed ~4h BTC price move afterward?","do_not_infer":["Do not treat outcome_4h_pct as vault PnL, depositor returns, or trade advice.","Do not treat similarity_pct as win probability (it is cosine similarity on 7 features, not a calibrated forecast).","Do not count multiple TOP3 rows on the same calendar day as independent confirmations unless episode_diversity.independent_calendar_days supports it.","Do not align vault LONG/SHORT with BTC outcome_4h_pct without an explicit vault signal from get_btc_usdc_signal.","Do not narrate bullish/bearish conviction when confidence_tier is low or cluster_warning_en is set.","If data_available is false, do not invent matches or outcomes."],"required_agent_behavior":["Quote interpretation_contract_v1.do_not_infer (or summarize all bullets) when presenting results to end users.","If episode_diversity.cluster_warning_en is non-null, include it verbatim before any directional takeaway.","State confidence_tier explicitly; never upgrade it in prose.","Separate BTC spot analogy from vault position; they are different instruments and timelines."]},"confidence_tier_rationale_en":"Matches are clustered (same day and/or identical similarity scores); analogy is illustrative, not multi-sample confirmation."}},"exampleRequest":{"full":"true"},"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_mXyAF71wjpgHzxZcaqiYy","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns pattern-similarity matches for a trading symbol against historical price patterns, including predicted outcome and confidence score.","exampleAgentPrompt":"Check HYPERNATT's similarity-match for BTC right now and give me the full match payload — I want to see the top historical pattern matches, their similarity scores, and what price outcome they predicted.","exampleUseCases":[{"title":"Real-time reversal signal detection for swing trades","prompt":"Run a pattern similarity check on ETH and tell me if the current chart looks like any of the historical reversal patterns — I need to know the similarity scores and whether they predicted reversals up or down."},{"title":"Confirm chart setup before entering position","prompt":"I'm thinking about going long on SOL. Can you pull the full pattern matches from HYPERNATT and show me which historical setups this current one resembles most? I want to see the confidence scores and outcomes."},{"title":"Portfolio divergence analysis across symbols","prompt":"Check pattern similarity for BTC, ETH, and XRP all at once and compare the results. Tell me which ones are showing the strongest historical pattern matches and what those historical outcomes were — I need to see if they're moving together or diverging."}],"resultDescription":"Returns a JSON object with ok status, the trading symbol (e.g. BTC), and a list of top matches each containing a similarity score (0-1), a time horizon in minutes, and an observed historical outcome label such as 'reversal_up'. With the 'full' query parameter set to 'true', additional match detail is included.","failureModes":["Missing or invalid 'input' object with required 'type' and 'method' fields returns a validation error","Payment not provided or insufficient USDC results in 402 Payment Required","No historical matches found for current pattern returns empty top_matches array","Symbol not supported or unrecognized returns an error response","Service downtime or neural model unavailability returns 5xx error"],"whenToPreferThis":"Choose this endpoint when you need to identify how closely current market price patterns resemble historical patterns for a crypto asset, especially when you want probabilistic short-term outcome predictions (e.g. reversal_up) based on pattern similarity. It is distinct from generic price feed or sentiment APIs because it returns structured similarity scores tied to historical observed outcomes over specific time horizons.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:40:00.849Z","isFirstParty":false}