safin 0.1.0

Python SDK for the hosted safin Seeking Alpha market-data API.

safin Python SDK

Python SDK for safin, the hosted Seeking Alpha market-data API.

pip install safin

from safin import Client

sa = Client(contact="[e-mail]")

quote = sa.quote("GRAB")
ratios = sa.metrics_ratios("GRAB", fields=["pe_ratio", "ps_ratio"])
valuation = sa.valuation("GRAB")
history = sa.historical_prices("GRAB", start="2026-04-01", end="2026-05-05")
chain = sa.options_chain(ticker_id=605799, expiration_date="2026-05-15")

The default base URL is the verified Worker deployment:

https://safin-api.crombiesamuel.workers.dev

Override it with SAFIN_BASE_URL or Client(base_url=...). The configured custom domain target is https://api.safin.bluedoor.sh once DNS is live.

Public Methods

• Discovery: health(), endpoints(), openapi()
• Quotes: quote(symbol), quotes(symbols), quotes_by_id(sa_ids)
• Options: options_by_symbols(symbols), options_chain(ticker_id, expiration_date), options_expirations(symbol)
• Metrics and fundamentals: metrics_ratios(symbol), metrics_market(symbol), symbol_data(symbol), valuation(symbol), estimates(ticker_id), fundamentals(symbol), fundamentals_metrics(symbol)
• History and ownership: historical_prices(symbol), shares(symbol)
• News: news(symbol)

All methods return the hosted API's JSON envelope as a dict.

Identity

• Anonymous: works without configuration.
• Contact tier: Client(contact="[e-mail]") sends X-Safin-Contact.
• Manual API key tier: Client(api_key="...") sends Authorization: Bearer ....

Environment variables: SAFIN_BASE_URL, SAFIN_CONTACT, SAFIN_API_KEY.