# omni-datastream-py

Python SDK for Omni Datastream.

## Example

```python
from omni_datastream_py import OmniDatastreamClient

client = OmniDatastreamClient(
    api_key="ods_test_...",
    # Default base_url is https://api.secapi.ai; override for local dev, e.g. "http://127.0.0.1:8787"
)

print(client.resolve_entity(ticker="AAPL"))
print(client.latest_filing(ticker="AAPL", form="10-K"))
print(client.latest_section(section_key="item_1a", ticker="AAPL", form="10-K", mode="compact"))
print(client.facts(ticker="AAPL", tag="Assets", taxonomy="us-gaap", limit=5))
print(client.all_statements(ticker="AAPL", period="annual", limit=3))
print(client.offerings(forms="S-1,424B4", limit=3))
print(client.market_calendar(market="XNYS", duration=3))
print(client.volatility_signal(ticker="AAPL"))
print(client.latest_13f(cik="0001067983", limit=10))
print(client.artifact_summary())
print(client.observability())
```

## Scope

The Python SDK mirrors the current REST surface for:
- search and filing workflows
- facts and statements
- offerings, market-calendar, and volatility-score utilities
- ownership, insiders, and compensation
- artifacts, diagnostics, and observability
- events, streams, and webhooks
