tickers 0.1.0

Python SDK for the Tickers Data API

tickers-py

Python SDK for the Tickers Data API

pip install tickers

Quick Start

from tickers import TickersData

td = TickersData(api_key="td_live_...")

# List filings
filings = td.filings.list(ticker="AAPL", form="10-K", limit=5)
for f in filings:
    print(f"{f.filed_date} — {f.form} — {f.description}")

# Search filings
results = td.filings.search(q="cybersecurity incident", form="8-K", start_date="2024-01-01")

# Semantic search (vector)
chunks = td.filings.chunks(query="supply chain risks", ticker="AAPL")

# Ask with citations (streaming)
for event in td.filings.ask("What are Apple's main revenue risks?", ticker="AAPL"):
    if event.type == "sources":
        print(f"Sources: {len(event.mapping)} documents")
    elif event.type == "chunk":
        print(event.content, end="")
    elif event.type == "done":
        print(f"\n\nLatency: {event.usage.latency_ms}ms")

# Reference data
types = td.reference.filing_types()

Authentication

# Via constructor
td = TickersData(api_key="td_live_...")

# Via environment variable
# export TICKERS_API_KEY=td_live_...
td = TickersData()

License

MIT