Metadata-Version: 2.4
Name: bargo-congress
Version: 0.1.0
Summary: Official Python client for the Bargo Congress Trades API: https://www.bargo.ai/free-apis/congress
Author: Bargo AI
License-Expression: MIT
Project-URL: Homepage, https://www.bargo.ai/free-apis/congress
Project-URL: Documentation, https://www.bargo.ai/free-apis/congress
Project-URL: Repository, https://github.com/bargo-ai/bargo-free-api-packages
Keywords: bargo,congress,stocks,trades,stock-act,api
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Office/Business :: Financial
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# bargo-congress

Official Python client for the Bargo Congress Trades API.

API docs: https://www.bargo.ai/free-apis/congress

## Install

```bash
pip install bargo-congress
```

## Usage

```python
from bargo_congress import BargoCongressClient

client = BargoCongressClient(api_key="optional")

nvda = client.ticker_trades("NVDA", limit=2)
print(nvda["trades"])
```

Keyless usage also works:

```python
from bargo_congress import BargoCongressClient

client = BargoCongressClient()
stats = client.stats()
print(stats)
```

## Methods

- `client.health()`
- `client.stats()`
- `client.members(limit=100)`
- `client.member("member-slug", limit=100)`
- `client.trades(ticker="NVDA", limit=2)`
- `client.trades(member="sheldon-whitehouse", limit=10)`
- `client.ticker_trades("NVDA", limit=2)`

Aliases are also available: `get_trades`, `get_ticker_trades`, `get_members`, `get_member`, `get_stats`, and `get_health`.

## Limits

- Keyless: 30 requests/day and 100 rows/day per IP
- Free API key: 100 requests/day and 1,000 rows/day
- Page size: up to 100 rows keyless, up to 250 rows with a key

Quotas are reported per response in the `X-RateLimit-*` headers. Treat those as
authoritative.

## Attribution

If you display Bargo Congress API data publicly, include visible attribution linking to Bargo.

