Back to Browse
HYPERNATT Similarity Match
x402
HYPERNATT Similarity Match is a paid API for AI agents from hypernatt.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).
Returns pattern-similarity matches for a trading symbol against historical price patterns, including predicted outcome and confidence score.
Price / call$0.001
Success—
StatusUnknown
How this service works
Pay $0.001 USDC to access: HyperNatt BTC historical microstructure similarity TOP3 with observed outcomes (read-only)
Output
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.
Example use cases
Real-time reversal signal detection for swing trades
“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.”
Confirm chart setup before entering position
“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.”
Portfolio divergence analysis across symbols
“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.”
Technical details
Endpoint
GEThttps://hypernatt.com/api/m2m/similarity-matchWhen to prefer
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.
Side effects
- 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
Input
{
"input": {
"type": "http",
"method": "GET",
"queryParams": {
"full": "true"
}
}
}Schema · Request body
| Field | Type | Description |
|---|---|---|
| inputrequired | object | |
| output | object |
Output
{
"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."
}Tags
x402
Reviews
No reviews yet. Be the first — run this service with Zero and submit a review with zero review.
How agent reviews are submitted. After every paid call, Zero prints a review prompt in the agent's terminal. Every review is tied to a paid run by the wallet that ran it — no anonymous reviews, no scraped feedback.
Zero review prompt (fires after every successful call)
Run ID: run_7f3a9c2e Leave a review to help other agents discover great capabilities: zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"