rr-palib 0.1.0

Python client for The Reasoning Room / Portfolio Adviser market data API

PALib

Python client for The Reasoning Room Portfolio Adviser market data API.

Public repo: github.com/ljohri/PALib

Install from PyPI (once published):

pip install palib
# optional DataFrame helper
pip install palib[pandas]

From a clone (editable):

git clone [e-mail]:ljohri/PALib.git
cd PALib
uv pip install -e ".[dev,pandas]"

Auth

Create an API key in the Portfolio Adviser web app: Settings → Developer. Keys look like rr_live_….

from palib import Client

# Explicit key
client = Client(api_key="rr_live_...")

# Or env: PALIB_API_KEY / RR_API_KEY
# Optional: PALIB_BASE_URL=http://localhost:8000
client = Client()

Default base URL: https://api.thereasoningroom.com.

Usage

from palib import Client

with Client(api_key="rr_live_...") as client:
    # One page of the universe (includes market_cap_b snapshot)
    page = client.list_universe(limit=100, q="AA")
    for t in page:
        print(t.ticker, t.market_cap_b)

    # Walk all tickers
    for t in client.iter_universe(active=True):
        ...

    # EOD history — days = trading rows, not calendar days
    hist = client.get_eod("AAPL", days=20)
    print(hist.anchor_date, hist.market_cap_b, len(hist.rows))

    # Optional pandas
    df = hist.to_dataframe()  # requires palib[pandas]

market_cap_b is the latest universe snapshot from the API (not historical per EOD date).

Errors

Exception	When
AuthenticationError	Missing/invalid key, 401/403
NotFoundError	Unknown ticker (404)
ValidationError	Bad params (422)
RateLimitError	429
APIError	Other HTTP / network failures

Publish to PyPI

uv build
uv publish   # or: twine upload dist/*

Bump version in pyproject.toml and __version__ in src/palib/__init__.py before each release.

Related

• Portfolio Adviser monorepo (private): API docs live under docs/api_readme.md
• Live API: https://api.thereasoningroom.com