Compound multi-product brief for one symbol
One request that fans across every Kresmion product server-side and returns a single structured digest for one symbol: so an agent spends one round-trip instead of eight. Purpose-built for LLM agents and apps that need a fast, broad situational read before deciding where to drill down.
When to use this vs the per-product endpoints: Call the brief FIRST to get the lay of the land for a symbol: what signals fired, who is trading it, where the flows and positioning sit, what the crowd is pricing, and the macro backdrop. Each section is a small digest capped at 5-10 rows, NOT a full dump. When a section looks interesting, drill down via its dedicated endpoint (named below) for the full, filterable, windowed series.
Path: asset_class is crypto or equity (anything else → 422). symbol is uppercased and bounded to 12 chars. A crypto symbol is a bare ticker (BTC, ETH, SOL, XRP, …); an equity symbol is a stock ticker (NVDA, AAPL, …).
crypto sections: signals (→ /v1/signals, /v1/equities/signals for equities), whale_transfers (≥ $1M on-chain, 72h, self-transfer artifact excluded → /v1/crypto/whales), etf_flows (BTC/ETH/SOL spot-ETF AUM and flows → /v1/crypto/etf/flows; BTC/ETH NYSE-session flows are withheld there and here, total_kind 'withheld', withheld_reason 'source_not_licensed'), derivatives (aggregate OI + OI-weighted funding → /v1/crypto/derivatives/{symbol}), funding (latest settled funding per exchange → /v1/crypto/derivatives/{symbol}/funding-history), prediction_markets (top 5 by volume → /v1/prediction/markets), regime (shared macro backdrop → /v1/macro/regime).
equity sections: signals (→ /v1/equities/signals), insider_clusters (→ /v1/equities/insider-clusters), congress (→ /v1/equities/congress), institutional (latest 13F quarter → /v1/equities/institutional), short_volume (→ /v1/equities/short-volume), gamma (modeled dealer GEX; present only for tickers in the options gamma table → /v1/equities/gamma), prediction_markets (→ /v1/prediction/markets), regime (→ /v1/macro/regime).
Shape: data maps each section name to {data, as_of, count?} (list sections carry count; some carry a caveat string). Top-level as_of is the max of the section timestamps. meta.sections_empty lists sections with no data for this symbol; meta.sections_degraded (present only if non-empty) lists sections whose query failed: a degraded section is {"error": "unavailable"} and never fails the whole brief.
Unknown / no-data symbol: returns 200 with every section empty and all listed in meta.sections_empty (agents handle empties better than a 404). Only an invalid asset_class returns 422.
Framing: event data only; no advice, no buy/sell. direction fields are machine tags. Read the caveat on whale_transfers (BTC netflow) and institutional (13F resolution / lag) before interpreting.
Request
- Base URL: https://kresmion.com/v1
- URL: https://kresmion.com/v1/brief/{asset_class}/{symbol}
- Auth: HTTP bearer
Path parameters
Supported asset classes. An out-of-enum value → FastAPI 422 (documented allowed values in the spec), exactly the task's 422 on invalid asset_class.
crypto | equity (else 422).
Ticker; uppercased, ≤ 12 chars.
Headers
Response
Successful Response
Changes
No recorded changes to this operation across all 1 revision of this API.