Context API — AI-Ready Financial Context in One Call
The Context API answers a natural-language financial question in a single call. Send a question like “Bitcoin sentiment over the last week” or “how is the ECB rate decision affecting EUR/USD” and get back exactly the sources you need — news, sentiment, prices, and our own analysis — either as raw structured data for your own agent to reason over, or as a ready-to-use written answer with cited sources.
Endpoint: POST /api/v1/context
Auth: same API key as the rest of the SentiSignal API
(Authorization or x-api-key header).
Two modes available today
Lite mode (mode=lite, the default)
Raw, structured data, no prose. A fast routing step picks the relevant sources for your question and returns
them as-is: news items with AI-generated summaries, sentiment scores, licensed price data, and more. Nothing
is written or paraphrased for you — this mode is built for callers who want to feed the result into their
own LLM or agent and write their own answer. It is also the cheapest and fastest mode, and it is what you get
if you omit the mode parameter entirely, so a quick integration never accidentally triggers a
more expensive call.
Standard mode (mode=standard)
Everything lite mode returns, plus a ready-to-read written answer with the sources it drew on. We run this answer through an anti-plagiarism safeguard before returning it, so you never receive verbatim copied text from any source — only an original paraphrase in our own words, grounded in and citing the real sources behind it.
Coming soon: Advanced mode
Advanced mode (mode=advanced) is planned but not yet available. Requesting it today returns an
explicit “not implemented yet” error rather than any partial or best-effort behavior — no
other mode is silently substituted.
What you will never get back from either mode
- Cryptocurrency prices. Our crypto price data is licensed for internal use only, not for redistribution through an API, so it is used behind the scenes to ground routing and never appears in your response. If your question resolves only to a crypto price with nothing else to show, you will get a clear “no sources found” response rather than a raw price.
- Full article text. News results always come back as an AI-generated summary plus a link to the original publisher, never the publisher’s full original text — this protects publisher copyright and keeps every response concise.
- Our own content (articles we publish on SentiSignal) is the one exception — since we own it, it comes back in full.
Limits, the same for every plan
- At most 10 news items per call, regardless of how broad your question is or what limit you request. This keeps every response focused and fast to read.
- Price data comes back at a granularity that adapts to your question’s time window — a one-day question gets fine granularity, a one-year question gets coarser data, automatically.
- The functional surface — which modes, filters, and data types are available — is identical on every paid plan. Plans differ only in how much you can use (requests, tokens per period), never in what you can access. The one exception is the crypto-price restriction above, which applies equally to every plan because it is a data-licensing rule, not a plan feature.
Error handling
Every response is either a successful result or a clear, structured error — an invalid request, a missing or invalid API key, a “no sources found” for an unanswerable question, or (standard mode only) a rare case where we could not produce an answer we were confident was sufficiently original, in which case we ask you to narrow your question rather than return something we are not confident about.
Get started
Use your existing SentiSignal API key. See the full technical reference for exact request/response shapes and error codes.