publicdotcom-cli 1.0.0__tar.gz → 1.1.0__tar.gz

{publicdotcom_cli-1.0.0 → publicdotcom_cli-1.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: publicdotcom-cli
-Version: 1.0.0
+Version: 1.1.0
 Summary: Command-line client for the Public.com Trading API
 Project-URL: Homepage, https://github.com/publicdotcom/publicdotcom-cli
 Project-URL: Repository, https://github.com/publicdotcom/publicdotcom-cli
@@ -185,6 +185,35 @@ public market quotes AAPL MSFT --type EQUITY
 public market option-expirations AAPL
 public market option-chain AAPL 2026-05-15
 public options greeks "AAPL  260515C00200000"
+public historicdata bars AAPL YEAR
+public historicdata bars AAPL DAY --aggregation FIVE_MINUTES
+public historicdata bars AAPL SINCE_PURCHASE --purchase-date 2024-01-15
+```
+
+## Historic Bar Data
+
+Fetch OHLCV bar data for a symbol over a given time period:
+
+```bash
+public historicdata bars AAPL YEAR
+public historicdata bars BTC-USD WEEK
+```
+
+Available periods: `DAY`, `WEEK`, `MONTH`, `QUARTER`, `HALF_YEAR`, `YEAR`, `FIVE_YEARS`, `YTD`, `SINCE_PURCHASE`.
+
+Override the default bar aggregation with `--aggregation`:
+
+```bash
+public historicdata bars AAPL DAY --aggregation FIVE_MINUTES
+public historicdata bars AAPL MONTH --aggregation ONE_HOUR
+```
+
+Available aggregations: `ONE_MINUTE`, `FIVE_MINUTES`, `TEN_MINUTES`, `FIFTEEN_MINUTES`, `THIRTY_MINUTES`, `ONE_HOUR`, `ONE_DAY`, `ONE_WEEK`, `ONE_MONTH`, `THREE_MONTHS`, `SIX_MONTHS`, `ONE_YEAR`.
+
+When using the `SINCE_PURCHASE` period, supply the purchase date:
+
+```bash
+public historicdata bars AAPL SINCE_PURCHASE --purchase-date 2024-01-15
 ```
 
 Trading requests use JSON files so the exact payload is visible before submission:

{publicdotcom_cli-1.0.0 → publicdotcom_cli-1.1.0}/README.md

@@ -148,6 +148,35 @@ public market quotes AAPL MSFT --type EQUITY
 public market option-expirations AAPL
 public market option-chain AAPL 2026-05-15
 public options greeks "AAPL  260515C00200000"
+public historicdata bars AAPL YEAR
+public historicdata bars AAPL DAY --aggregation FIVE_MINUTES
+public historicdata bars AAPL SINCE_PURCHASE --purchase-date 2024-01-15
+```
+
+## Historic Bar Data
+
+Fetch OHLCV bar data for a symbol over a given time period:
+
+```bash
+public historicdata bars AAPL YEAR
+public historicdata bars BTC-USD WEEK
+```
+
+Available periods: `DAY`, `WEEK`, `MONTH`, `QUARTER`, `HALF_YEAR`, `YEAR`, `FIVE_YEARS`, `YTD`, `SINCE_PURCHASE`.
+
+Override the default bar aggregation with `--aggregation`:
+
+```bash
+public historicdata bars AAPL DAY --aggregation FIVE_MINUTES
+public historicdata bars AAPL MONTH --aggregation ONE_HOUR
+```
+
+Available aggregations: `ONE_MINUTE`, `FIVE_MINUTES`, `TEN_MINUTES`, `FIFTEEN_MINUTES`, `THIRTY_MINUTES`, `ONE_HOUR`, `ONE_DAY`, `ONE_WEEK`, `ONE_MONTH`, `THREE_MONTHS`, `SIX_MONTHS`, `ONE_YEAR`.
+
+When using the `SINCE_PURCHASE` period, supply the purchase date:
+
+```bash
+public historicdata bars AAPL SINCE_PURCHASE --purchase-date 2024-01-15
 ```
 
 Trading requests use JSON files so the exact payload is visible before submission:

{publicdotcom_cli-1.0.0 → publicdotcom_cli-1.1.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "publicdotcom-cli"
-version = "1.0.0"
+version = "1.1.0"
 description = "Command-line client for the Public.com Trading API"
 readme = "README.md"
 requires-python = ">=3.10"

{publicdotcom_cli-1.0.0 → publicdotcom_cli-1.1.0}/src/publicdotcom_cli/__init__.py

@@ -1,3 +1,3 @@
 """Command-line tools for the Public API."""
 
-__version__ = "1.0.0"
+__version__ = "1.1.0"

{publicdotcom_cli-1.0.0 → publicdotcom_cli-1.1.0}/src/publicdotcom_cli/cli.py

@@ -47,6 +47,7 @@ instruments_app = typer.Typer(help="Instrument lookup commands.")
 market_app = typer.Typer(help="Market data commands.")
 options_app = typer.Typer(help="Option details commands.")
 order_app = typer.Typer(help="Order and preflight commands.")
+historicdata_app = typer.Typer(help="Historic bar data commands.")
 
 app.add_typer(auth_app, name="auth")
 app.add_typer(accounts_app, name="accounts")
@@ -56,6 +57,7 @@ app.add_typer(instruments_app, name="instruments")
 app.add_typer(market_app, name="market")
 app.add_typer(options_app, name="options")
 app.add_typer(order_app, name="order")
+app.add_typer(historicdata_app, name="historicdata")
 
 
 @dataclass
@@ -757,5 +759,39 @@ def order_cancel(
     _print(ctx, result if result is not None else {"cancelRequested": True})
 
 
+@historicdata_app.command("bars")
+def historicdata_bars(
+    ctx: typer.Context,
+    symbol: Annotated[str, typer.Argument(help="Ticker symbol, e.g. AAPL.")],
+    period: Annotated[
+        str,
+        typer.Argument(
+            help="Time period: DAY, WEEK, MONTH, QUARTER, HALF_YEAR, YEAR, FIVE_YEARS, YTD, SINCE_PURCHASE."
+        ),
+    ],
+    aggregation: Annotated[
+        str | None,
+        typer.Option(
+            "--aggregation",
+            help=(
+                "Bar aggregation override: ONE_MINUTE, FIVE_MINUTES, TEN_MINUTES, "
+                "FIFTEEN_MINUTES, THIRTY_MINUTES, ONE_HOUR, ONE_DAY, ONE_WEEK, "
+                "ONE_MONTH, THREE_MONTHS, SIX_MONTHS, ONE_YEAR."
+            ),
+        ),
+    ] = None,
+    purchase_date: Annotated[
+        str | None,
+        typer.Option("--purchase-date", help="Required when period is SINCE_PURCHASE. YYYY-MM-DD."),
+    ] = None,
+) -> None:
+    if aggregation:
+        path = f"/userapigateway/historicdata/{symbol.upper()}/{period.upper()}/{aggregation.upper()}"
+    else:
+        path = f"/userapigateway/historicdata/{symbol.upper()}/{period.upper()}"
+    result = _call(ctx, "GET", path, params={"purchaseDate": purchase_date})
+    _print(ctx, result)
+
+
 def main() -> None:
     app()