forecite 0.1.0

Official Python SDK for the Forecite API — scored news feed (REST), Verdict scoring, and realtime WebSocket streaming.

forecite (Python SDK)

Official Python SDK for the Forecite API — the scored news feed (REST), the Verdict scoring engine, and the realtime WebSocket stream. Fully type-hinted, sync, minimal dependencies.

Install

pip install forecite

Quick start

from forecite import Forecite

forecite = Forecite("fc_live_your_key")
# or: Forecite(api_key, base_url=..., ws_url=...)

# REST — list scored feeds
res = forecite.feeds.list(symbol="TSLA", limit=20)
print(res["data"], res["next_cursor"])

# Score an artifact (Pro+)
verdict = forecite.score({
    "type": "news",
    "title": "Acme beats earnings",
    "body": "Acme reported Q2 revenue of …",
})

# Account + usage
me = forecite.me()
usage = forecite.usage(days=14)

Realtime stream

def on_feed(item):
    print(item["title"], "→", item.get("scoring"))

stream = forecite.stream(
    filters={"symbols": ["TSLA", "AAPL"]},
    snapshot=10,
    on_feed=on_feed,
    on_welcome=lambda w: print("connected:", w["tier"]),
)
stream.run()              # blocks; or stream.run_in_thread()
# stream.close()

API surface

Group	Methods
Feeds	feeds.list(**query), feeds.get(id)
Scoring	score(artifact, options=None)
Account	me(), usage(days=30)
Reference	providers.list/get, sources.list/get, symbols.list/get, tags.list/get
Webhooks	webhooks.list/create/get/update/delete
Realtime	stream(filters=…, snapshot=…, on_feed=…)

Config

Forecite(
    api_key="fc_live_…",
    base_url="http://localhost:3000/api",  # local dev (default: https://api.forecite.com)
    ws_url="ws://localhost:8080",          # local dev (default: wss://ws.forecite.com)
)

Errors raise ForeciteError with .status and .code.