v0.2.0

Breaking change

to_pandas() and to_polars() on a list now convert only the page you have, so they never send requests you didn't ask for. In 0.1.0 they followed pages until they had 10,000 rows.

Call	Rows
.to_pandas()	this page, with a MorePagesWarning if more pages remain
.to_pandas(all_pages=True)	every page
.to_pandas(max_items=N)	this page and the next ones, up to N rows
.to_pandas(all_pages=False)	this page, without the warning

To keep 0.1.0's behaviour, pass max_items=10_000.

Other changes

• The PyPI homepage and documentation links point to https://www.roic.ai.

v0.1.0

First release of the official ROIC.ai Python library.

• Sync and async clients (Roicai, AsyncRoicai) for every v3 endpoint: tickers, company profiles, stock and forex prices, financial statements, ratios and multiples, earnings call transcripts, the earnings calendar, SEC filings and other company documents.
• Typed Pydantic models, with dates as datetime.date.
• Lists that fetch their next pages as you iterate.
• to_pandas() and to_polars() on every response, with column types from the API's schema (pip install "roicai[pandas]" or "roicai[polars]").
• Errors with the API's message, code and request_id; automatic retries that honour Retry-After.

pip install roicai

See the README to get started.