For AI builders

Your model reads it.
No preprocessing needed.

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?

// context injected automatically
{ Konseki JSON → see below }
Konseki JSON injected
{"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

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

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.

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

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.