Konseki returns structured JSON with outcome distributions, reliability scores, and pre-written commentary. Drop it into a prompt — your model understands it natively and reasons from real historical evidence.
Live demo — real AAPL data → real model response● Pre-run demo
Your prompt
// system prompt You are a trading assistant. Answer using only the provided market context data. Be concise and cite specific numbers.
// user message What does AAPL's current setup look like? What usually happened historically in the different forward windows after this setup? Is it a good timing to get into the market?
{"meta":{"schema_version":"1.0","generated_at":"2026-06-22T19:47:40Z","data_through":"2026-06-18","timeframe":"1d","universe":"sp500","lookback_periods":15},"benchmark":{"symbol":"AAPL","exchange":"NASDAQ","name":"Apple Inc.","country":"United States","sector":"","industry":"","context":{"5":{"volatility":0.0142,"normalized_slope":0.0774,"close_position_range":0.6739,"log_volume_zscore":1.7545,"max_drawdown":-0.011},"10":{"volatility":0.0174,"normalized_slope":0.1451,"close_position_range":0.3541,"log_volume_zscore":1.5668,"max_drawdown":-0.0546},"15":{"volatility":0.0173,"normalized_slope":0.0292,"close_position_range":0.3541,"log_volume_zscore":1.8654,"max_drawdown":-0.0782},"20":{"volatility":0.0157,"normalized_slope":-0.0164,"close_position_range":0.3541,"log_volume_zscore":2.2238,"max_drawdown":-0.0782},"25":{"volatility":0.0143,"normalized_slope":-0.0132,"close_position_range":0.3541,"log_volume_zscore":2.3411,"max_drawdown":-0.0782},"30":{"volatility":0.0138,"normalized_slope":-0.0185,"close_position_range":0.392,"log_volume_zscore":2.5565,"max_drawdown":-0.0782},"40":{"volatility":0.0141,"normalized_slope":-0.0113,"close_position_range":0.6312,"log_volume_zscore":2.213,"max_drawdown":-0.0782},"50":{"volatility":0.0148,"normalized_slope":-0.0086,"close_position_range":0.6851,"log_volume_zscore":2.32,"max_drawdown":-0.0782}}},"analysis":{"evidence_count":15,"unique_symbols":15,"diversity":{"score":0.9524,"symbol_diversity":1,"time_diversity":0.9048},"match_quality":{"median_overall_score":5,"median_shape_similarity":5,"median_similarity_score":0.1718,"median_shape_distance":0.438,"quality_tag":"strong"},"forward_outcome":{"3":{"returns":{"positive_return_rate":0.6667,"average_return":0.0253,"median_return":0.0123,"worst_return":-0.0578,"best_return":0.2057,"max_favourable_excursion":0.2278,"max_adverse_excursion":-0.0951,"percentiles":{"p05":-0.0455,"p25":-0.0118,"p50":0.0123,"p75":0.0477,"p95":0.114}},"tags":{"direction":"bullish_moderate","consistency":"moderate","reliability":"moderate","risk":"high_tail","outlier":"upside_outlier_driven"},"commentary":{"headline":"Moderately bullish skew with elevated downside risk","summary":"Similar setups appeared 15 times historically. Over the next 3 trading days, the setup finished higher 67% of the time with a median move of +1.2%.","risk":"Tail risk was significant. Similar setups occasionally produced sharp adverse outcomes, with the weakest historical case at -5.8% over 3 trading days.","takeaway":"Similar setups historically leaned positive over 3 trading days, but downside risk was large enough that position sizing and risk control would matter."}},"5":{"returns":{"positive_return_rate":0.6,"average_return":0.0352,"median_return":0.0339,"worst_return":-0.076,"best_return":0.1305,"max_favourable_excursion":0.246,"max_adverse_excursion":-0.0951,"percentiles":{"p05":-0.0418,"p25":-0.0028,"p50":0.0339,"p75":0.0765,"p95":0.1025}},"tags":{"direction":"bullish_moderate","consistency":"moderate","reliability":"moderate","risk":"high_tail","outlier":"normal"},"commentary":{"headline":"Moderately bullish skew with elevated downside risk","summary":"Similar setups appeared 15 times historically. Over the next 5 trading days, the setup finished higher 60% of the time with a median move of +3.4%.","distribution":"Average return was +3.5%, compared with a median return of +3.4%.","risk":"Tail risk was significant. Similar setups occasionally produced sharp adverse outcomes, with the weakest historical case at -7.6% over 5 trading days.","takeaway":"Similar setups historically leaned positive over 5 trading days, but downside risk was large enough that position sizing and risk control would matter."}},"10":{"returns":{"positive_return_rate":0.6667,"average_return":0.0361,"median_return":0.0522,"worst_return":-0.0772,"best_return":0.1585,"max_favourable_excursion":0.246,"max_adverse_excursion":-0.0951,"percentiles":{"p05":-0.0553,"p25":-0.0124,"p50":0.0522,"p75":0.0784,"p95":0.1293}},"tags":{"direction":"bullish_strong","consistency":"moderate","reliability":"moderate","risk":"high_tail","outlier":"normal"}},"15":{"returns":{"positive_return_rate":0.6,"average_return":0.0347,"median_return":0.0217,"worst_return":-0.0886,"best_return":0.1769,"max_favourable_excursion":0.246,"max_adverse_excursion":-0.1137,"percentiles":{"p05":-0.0713,"p25":-0.0297,"p50":0.0217,"p75":0.0924,"p95":0.151}},"tags":{"direction":"bullish_moderate","consistency":"low","reliability":"moderate","risk":"high_tail","outlier":"normal"}}}},"matches":[{"symbol":"COO","exchange":"NASDAQ","name":"The Cooper Companies, Inc.","period":{"start":"2008-11-11","end":"2008-12-02"},"similarity_score":0.329,"match_quality":{"overall_score":4,"scores":{"shape_similarity":5,"trend_similarity":5,"volatility_similarity":2,"range_position_similarity":5,"volume_similarity":4,"risk_similarity":3}},"forward_outcome":{"returns":{"3":{"return":0.2057,"max_favourable_excursion":0.2278,"max_adverse_excursion":-0.015},"5":{"return":0.1305,"max_favourable_excursion":0.246,"max_adverse_excursion":-0.015},"10":{"return":0.0886,"max_favourable_excursion":0.246,"max_adverse_excursion":-0.053},"15":{"return":0.1725,"max_favourable_excursion":0.246,"max_adverse_excursion":-0.053}}}},{"symbol":"ALB","exchange":"NYSE","name":"Albemarle Corporation","period":{"start":"2008-11-11","end":"2008-12-02"},"similarity_score":0.3523,"match_quality":{"overall_score":4,"scores":{"shape_similarity":5,"trend_similarity":5,"volatility_similarity":1,"range_position_similarity":5,"volume_similarity":3,"risk_similarity":3}},"forward_outcome":{"returns":{"3":{"return":-0.0054,"max_favourable_excursion":0.0427,"max_adverse_excursion":-0.0951},"5":{"return":0.0805,"max_favourable_excursion":0.1383,"max_adverse_excursion":-0.0951},"10":{"return":0.0698,"max_favourable_excursion":0.1682,"max_adverse_excursion":-0.0951},"15":{"return":0.0568,"max_favourable_excursion":0.1682,"max_adverse_excursion":-0.0951}}}}]}
Model response
◎Click "See example response" to see Claude reason from the Konseki data
How it works
How it works
01
Call the API once per symbol
One request to GET /v1/analysis/{symbol} returns everything: outcome distributions, match quality, MAE/MFE, reliability tags, and pre-written commentary. No secondary calls. No joins.
02
Inject the JSON directly into your prompt
No transformation required. The response is already structured the way a model reasons — named fields, natural-language commentary, numeric evidence. Paste it in as-is.
03
The model cites real evidence
Your assistant can now say "historically, 60% of similar setups were positive over 5 days, with a median move of +3.4%" — because the evidence is right there in context, not hallucinated.
Why this matters for AI assistants
Why this matters for AI assistants
◈
Models don't have market memory
LLMs have broad financial knowledge but no access to what this specific stock looked like the last 15 days, or what happened next in similar historical setups. Konseki provides exactly that — per-symbol, per-day, computed fresh every close.
◈
The commentary field is prompt-ready
Every response includes a commentary object with pre-written fields: headline, summary, risk, takeaway. Your model can quote them, rephrase them, or use them as reasoning scaffolding — they're designed for LLM consumption.
◈
Grounded answers, not hallucinated statistics
When your assistant says "similar setups had a worst historical outcome of −7.6%", that number came from the JSON you provided. It's verifiable, sourced, and specific — not a statistical generalization your model invented from training data.
◈
No preprocessing pipeline to build
Financial data typically requires normalization, feature engineering, and interpretation before a model can use it. Konseki handles all of that upstream. You get a JSON response that's ready to inject — no pipeline, no transformation layer, no maintenance.
Key fields your model will use
commentary.summary
Pre-written natural language summary of the historical evidence. Drop it straight into context.
returns.positive_return_rate
What fraction of historical analogs finished positive over this forward window. A concrete, citable number.
tags.direction / tags.risk
Categorical signals your model can use for tone calibration: bullish_moderate, high_tail, etc.
returns.max_adverse_excursion
Worst intraday drawdown across historical cases — lets your assistant give honest downside context.
What builders are using it for
What builders are using it for
Chat assistant
Stock Q&A with historical grounding
User asks "how has AAPL behaved after setups like this?" — your assistant fetches the Konseki JSON and responds with actual historical outcome distributions, not general market knowledge.
Research copilot
Pre-trade context generation
Before a user reviews a position, inject the Konseki JSON into a system prompt. The model surfaces relevant risks, positive rates, and match quality without the user having to ask.
Alerts & digests
Automated morning briefings
Fetch Konseki data for a watchlist every morning, pass each symbol's JSON to a model, and generate a structured briefing: what setups are elevated risk, what looks historically constructive.
For AI builders
Give your AIhistorical market memory.
Free tier. All ~500 S&P 500 symbols. All lookback periods. All output fields. No credit card required.