One install. First verdict in sixty seconds.

Typed clients in Python, Node, and Go. Reconnect, auth rotation, and replay handled — you focus on what to do with each verdict, not how to keep the socket alive.

Read the docs View on GitHub

[01]Install

Pick a runtime. Run one command. Same protocol behind every binding — switch languages without relearning the wire.

Python

v0.18.2

$ pip install forecite

forecite

PyPI · 3.9+

Node

v1.4.0

$ npm i @forecite/sdk

@forecite/sdk

npm · Node 20+

v0.9.1

$ go get github.com/forecite/sdk-go

github.com/forecite/sdk-go

Go modules · 1.22+

[02]The surface

A small, deliberate API. Six methods cover 95% of use. Everything else is composition.

client.score()

stable

(text: str) -> Verdict

Score arbitrary text. Useful for ad-hoc back-tests.

stream.subscribe()

stable

(tickers, threshold?) -> Iterator[Verdict]

Live verdicts, server-side filtered. Auto-reconnects.

stream.replay()

stable

(cursor: int) -> Iterator[Verdict]

Replay missed verdicts from a sequence cursor.

client.verdicts()

stable

(query) -> Page[Verdict]

Paginated query over historical verdicts.

agent.tool()

preview

() -> McpTool

Drop-in MCP tool for any agent framework.

telemetry.latency()

stable

(event_id) -> LatencyReport

Per-event timing audit, end-to-end.

[03]Type safety

Types follow you into the editor. Every method, every payload, every event is typed end-to-end. Autocomplete tells you what a verdict carries before you ship.

editor.py

stream = VerdictStream(api_key="sk_live_…")

stream.

subscribe(tickers, threshold?)
replay(cursor: int)
api_key: str
reconnect(strategy?)
score(text: str)

5 results · type to filter

Type definitions ship in-package — no separate types repo, no version skew.

[04]CLI

A first-class command-line. Stream verdicts to your terminal, pipe them through jq, hand them to a cron. Every SDK ships with the same binary.

zsh — forecite⌘K

$ forecite login  # one-time auth→ Opened browser for OAuth handshake…✓ Logged in as jb.collet@hotmail.fr
$ forecite stream --tickers NVDA,META --threshold 0.616:01:03  NVDA   +0.83   28 ms   8-K earnings beat16:01:08  META   −0.52   31 ms   ad-revenue miss16:02:14  NVDA   +0.41   25 ms   guidance reiteration
$ forecite verdicts AAPL --since 1h --format json | jq '.[0]'$

Streams to stdout · pipe to jq, awk, anythingAuth via env var or OAuth handshake

Install. Subscribe. Trade.

Free tier gives you full SDK access, no credit card. Upgrade only when your throughput says you need to.

Start for free View on GitHub