massive-cli 0.0.1 → 0.0.2

package/README.md

@@ -1,8 +1,18 @@
-# Polygon (Massive) API CLI
+# Massive(Polygon) API CLI
 
-A CLI tool for accessing [Polygon.io](https://polygon.io) financial data (Stocks, Crypto, Forex, Options, Indices) using [Bun](https://bun.sh).
+A CLI tool for accessing [Massive(Polygon)](https://massive.com) financial data (Stocks, Crypto, Forex, Options, Indices) using [Bun](https://bun.sh).
 
-## Setup
+## Usage
+
+### Via NPX (Recommended)
+
+Run commands directly without installing:
+
+```bash
+npx massive <command> [options]
+```
+
+### Local Installation
 
 1.  **Install Dependencies:**
     ```bash
@@ -10,7 +20,10 @@ A CLI tool for accessing [Polygon.io](https://polygon.io) financial data (Stocks
     ```
 
 2.  **Configure API Key:**
-    Create a `.env` file in the root directory:
+    ```bash
+    export POLY_API_KEY=your_api_key_here
+    ```
+    or create a .env file in the root directory:
     ```
     POLY_API_KEY=your_api_key_here
     ```
@@ -20,20 +33,6 @@ A CLI tool for accessing [Polygon.io](https://polygon.io) financial data (Stocks
     bun run build
     ```
     This generates the bundled CLI in `dist/cli.js`.
-
-## Usage
-
-### Via NPX (Recommended)
-
-Run commands directly without installing:
-
-```bash
-npx massive <command> [options]
-```
-*(Requires Bun to be installed)*
-
-### Local Installation
-
 Run commands using the built CLI:
 
 ```bash

package/dist/cli.js

@@ -20504,9 +20504,9 @@ var COMMANDS = {
   ...newsCommands
 };
 function showHelp() {
-  console.log(`polygon - Polygon/Massive Market Data CLI
+  console.log(`massive - Massive Market Data CLI
 `);
-  console.log(`Usage: polygon <command> [options]
+  console.log(`Usage: npx massive <command> [options]
 `);
   console.log("Commands:");
   const maxLen = Math.max(...Object.keys(COMMANDS).map((k) => k.length));
@@ -20553,19 +20553,19 @@ function showHelp() {
       console.log(`  ${name.padEnd(maxLen + 2)} ${desc}`);
     }
   }
-  console.log("Use 'polygon <command> --help' for command-specific options.");
-  console.log("Set POLY_API_KEY in .env or environment.");
+  console.log("Use 'npx massive <command> --help' for command-specific options.");
+  console.log("Set MASSIVE_API_KEY in .env or environment.");
 }
 function showCommandHelp(command) {
   const cmd = COMMANDS[command];
   if (!cmd) {
     console.error(`Unknown command: ${command}`);
-    console.error("Run 'polygon help' to see available commands.");
+    console.error("Run 'npx massive help' to see available commands.");
     process.exit(1);
   }
   console.log(`${command} - ${cmd.desc}`);
   console.log(`
-Usage: polygon ${command} ${cmd.usage}`);
+Usage: npx massive ${command} ${cmd.usage}`);
 }
 async function main() {
   const { command, flags } = parseArgs(process.argv.slice(2));
@@ -20580,7 +20580,7 @@ async function main() {
   const cmd = COMMANDS[command];
   if (!cmd) {
     console.error(`Unknown command: ${command}`);
-    console.error("Run 'polygon help' to see available commands.");
+    console.error("Run 'npx massive help' to see available commands.");
     process.exit(1);
   }
   try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "massive-cli",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "Polygon/Massive Market Data CLI",
   "module": "index.ts",
   "type": "module",

package/dist/SKILL.md

@@ -1,55 +0,0 @@
----
-name: polygon-api
-description: Access Polygon/Massive stock, crypto, forex, options, indices, futures, market data, and news APIs via CLI.
-metadata:
-  openclaw:
-    requires:
-      bins: ["bun"]
-      env: ["POLY_API_KEY"]
-    primaryEnv: "POLY_API_KEY"
----
-
-# Polygon (Massive) Market Data Skill
-
-A CLI tool and JS client wrapper for the [Polygon/Massive](https://massive.com) financial data APIs. Covers stocks, crypto, forex, options, indices, futures, market status, news, and reference data.
-
-
-## CLI Usage
-
-```bash
-bun cli.js <command> [options]
-```
-
-All commands output JSON to stdout. Use `--help` for a list of commands or `<command> --help` for command-specific options.
-
-### Stocks
-
-See [Stocks Commands Reference](references/stocks_commands.md) for full details on all stock commands and parameters.
-
-### Crypto
-
-See [Crypto Commands Reference](references/crypto_commands.md) for full details on all crypto commands and parameters.
-
-### Forex
-
-See [Forex Commands Reference](references/forex_commands.md) for full details on all forex commands and parameters.
-
-### Options
-
-See [Options Commands Reference](references/options_commands.md) for full details on all options commands and parameters.
-
-### Indices
-
-See [Indices Commands Reference](references/indices_commands.md) for full details on all indices commands and parameters.
-
-### Reference Data
-
-See [Reference Data Commands Reference](references/reference_commands.md) for full details on all reference data commands and parameters.
-
-### Market
-
-See [Market Commands Reference](references/market_commands.md) for full details on all market commands and parameters.
-
-### News
-
-See [News Commands Reference](references/news_commands.md) for full details on all news commands and parameters.

package/dist/references/crypto_commands.md

@@ -1,142 +0,0 @@
-# Crypto Commands Reference
-
-This document provides details on the parameters and enums used in the Polygon/Massive Crypto CLI commands.
-
-## Enums
-
-### Timespans
-Used in `crypto-aggs`, `crypto-sma`, `crypto-ema`, `crypto-rsi`, `crypto-macd`:
-- **GetCryptoAggregatesTimespanEnum**: `second`, `minute`, `hour`, `day`, `week`, `month`, `quarter`, `year`
-- **GetCryptoSMATimespanEnum**: `minute`, `hour`, `day`, `week`, `month`, `quarter`, `year`
-- **GetCryptoEMATimespanEnum**: `minute`, `hour`, `day`, `week`, `month`, `quarter`, `year`
-- **GetCryptoRSITimespanEnum**: `minute`, `hour`, `day`, `week`, `month`, `quarter`, `year`
-- **GetCryptoMACDTimespanEnum**: `minute`, `hour`, `day`, `week`, `month`, `quarter`, `year`
-
-### Series Type
-Used in technical indicators (`crypto-sma`, `crypto-ema`, `crypto-rsi`, `crypto-macd`) to specify which price to use:
-- `open`, `high`, `low`, `close`
-
-### Order / Sort
-- **Sort**: `asc` (ascending), `desc` (descending)
-- **Order**: `asc`, `desc`
-- **Crypto Trades Sort**: `timestamp`
-
-### Snapshot Direction
-- `gainers`, `losers`
-
-## Commands and Parameters
-
-### `crypto-aggs`
-- `ticker` (string, required): Crypto ticker (e.g., X:BTCUSD)
-- `multiplier` (number): Timespan multiplier (default 1)
-- `timespan` (enum): See Timespans above (default 'day')
-- `from` (string, required): Start date (YYYY-MM-DD)
-- `to` (string, required): End date (YYYY-MM-DD)
-- `adjusted` (boolean): Adjust for splits (default true)
-- `sort` (enum): Sort order (default 'asc')
-- `limit` (number): Max results (default 120)
-
-**Example**:
-```bash
-bun cli.js crypto-aggs --ticker X:BTCUSD --from 2023-01-01 --to 2023-01-31 --timespan day
-```
-
-### `crypto-trades`
-- `ticker` (string, required): Crypto ticker
-- `timestamp` (string): Specific timestamp
-- `timestamp-gte`, `timestamp-gt`, `timestamp-lte`, `timestamp-lt`: Timestamp range filters
-- `order` (enum): Order of results
-- `limit` (number): Max results
-- `sort` (enum): Sort field
-
-**Example**:
-```bash
-bun cli.js crypto-trades --ticker X:BTCUSD --limit 5
-```
-
-### `crypto-snapshot`
-- `ticker` (string, required): Crypto ticker
-
-**Example**:
-```bash
-bun cli.js crypto-snapshot --ticker X:BTCUSD
-```
-
-### `crypto-snapshot-direction`
-- `direction` (enum, required): `gainers` or `losers`
-
-**Example**:
-```bash
-bun cli.js crypto-snapshot-direction --direction gainers
-```
-
-### `crypto-snapshot-tickers`
-- `tickers` (comma-separated strings): List of tickers
-
-**Example**:
-```bash
-bun cli.js crypto-snapshot-tickers --tickers X:BTCUSD,X:ETHUSD
-```
-
-### `crypto-open-close`
-- `from` (string, required): From symbol (e.g., BTC)
-- `to` (string, required): To symbol (e.g., USD)
-- `date` (string, required): Date (YYYY-MM-DD)
-- `adjusted` (boolean): Adjust for splits
-
-**Example**:
-```bash
-bun cli.js crypto-open-close --from BTC --to USD --date 2023-01-01
-```
-
-### `crypto-previous`
-- `ticker` (string, required): Crypto ticker
-- `adjusted` (boolean): Adjust for splits
-
-**Example**:
-```bash
-bun cli.js crypto-previous --ticker X:BTCUSD
-```
-
-### `crypto-grouped`
-- `date` (string, required): Date (YYYY-MM-DD)
-- `adjusted` (boolean): Adjust for splits
-
-**Example**:
-```bash
-bun cli.js crypto-grouped --date 2023-01-01
-```
-
-### Technical Indicators (`crypto-sma`, `crypto-ema`, `crypto-rsi`, `crypto-macd`)
-Common parameters:
-- `ticker` (string, required)
-- `timespan` (enum)
-- `window` (number)
-- `series-type` (enum)
-- `expand-underlying` (boolean)
-- `order` (enum)
-- `limit` (number)
-- Timestamp filters: `timestamp`, `timestamp-gte`, `timestamp-gt`, `timestamp-lte`, `timestamp-lt`
-
-Specific to `crypto-macd`:
-- `short-window` (number)
-- `long-window` (number)
-- `signal-window` (number)
-
-**Example**:
-```bash
-# SMA
-bun cli.js crypto-sma --ticker X:BTCUSD --timespan day --window 50
-
-# MACD
-bun cli.js crypto-macd --ticker X:BTCUSD --timespan day --short-window 12 --long-window 26 --signal-window 9
-```
-
-### `last-crypto-trade`
-- `from` (string, required)
-- `to` (string, required)
-
-**Example**:
-```bash
-bun cli.js last-crypto-trade --from BTC --to USD
-```

package/dist/references/forex_commands.md

@@ -1,237 +0,0 @@
-# Forex Commands Reference
-
-This document provides a reference for the forex-related commands available in the Polygon CLI.
-
-## Commands
-
-### forex-aggs
-Get aggregate bars (OHLCV) for a forex pair over a given date range.
-
-**Usage:**
-```bash
-bun cli.js forex-aggs --ticker <ticker> --from <YYYY-MM-DD> --to <YYYY-MM-DD> [options]
-```
-
-**Parameters:**
-- `--ticker` (required): Forex ticker symbol (e.g., C:EURUSD).
-- `--from` (required): Start date (YYYY-MM-DD).
-- `--to` (required): End date (YYYY-MM-DD).
-- `--multiplier` (number): Timespan multiplier (default: 1).
-- `--timespan` (string): Timespan unit (default: 'day'). Values: `second`, `minute`, `hour`, `day`, `week`, `month`, `quarter`, `year`.
-- `--adjusted` (boolean): Whether to adjust for splits (default: true).
-- `--sort` (string): Sort order (default: 'asc'). Values: `asc`, `desc`.
-- `--limit` (number): Max results (default: 120).
-
-**Example:**
-```bash
-bun cli.js forex-aggs --ticker C:EURUSD --from 2025-01-01 --to 2025-01-31 --timespan day --limit 10
-```
-
-### forex-quotes
-Get quotes for a forex pair.
-
-**Usage:**
-```bash
-bun cli.js forex-quotes --ticker <ticker> [options]
-```
-
-**Parameters:**
-- `--ticker` (required): Forex ticker symbol.
-- `--timestamp` (string): Query by specific timestamp.
-- `--timestamp-gte`, `--timestamp-gt`, `--timestamp-lte`, `--timestamp-lt` (string): Timestamp range filters.
-- `--limit` (number): Max results (default: 10).
-- `--sort` (string): Sort field (default: 'timestamp'). Values: `timestamp`.
-- `--order` (string): Sort order (default: 'asc'). Values: `asc`, `desc`.
-
-**Example:**
-```bash
-bun cli.js forex-quotes --ticker C:EURUSD --limit 5
-```
-
-### forex-snapshot
-Get the most recent snapshot for a forex pair.
-
-**Usage:**
-```bash
-bun cli.js forex-snapshot --ticker <ticker>
-```
-
-**Parameters:**
-- `--ticker` (required): Forex ticker symbol.
-
-**Example:**
-```bash
-bun cli.js forex-snapshot --ticker C:EURUSD
-```
-
-### forex-previous
-Get the previous day's open, high, low, and close (OHLC) for a forex pair.
-
-**Usage:**
-```bash
-bun cli.js forex-previous --ticker <ticker> [options]
-```
-
-**Parameters:**
-- `--ticker` (required): Forex ticker symbol.
-- `--adjusted` (boolean): Whether to adjust for splits (default: true).
-
-**Example:**
-```bash
-bun cli.js forex-previous --ticker C:EURUSD
-```
-
-### forex-grouped
-Get the daily open, high, low, and close (OHLC) for the entire forex market.
-
-**Usage:**
-```bash
-bun cli.js forex-grouped --date <YYYY-MM-DD> [options]
-```
-
-**Parameters:**
-- `--date` (required): Date of the requested aggregates (YYYY-MM-DD).
-- `--adjusted` (boolean): Whether to adjust for splits (default: true).
-
-**Example:**
-```bash
-bun cli.js forex-grouped --date 2025-01-15
-```
-
-### forex-sma
-Get Simple Moving Average (SMA) for a forex pair.
-
-**Usage:**
-```bash
-bun cli.js forex-sma --ticker <ticker> [options]
-```
-
-**Parameters:**
-- `--ticker` (required): Forex ticker symbol.
-- `--timestamp` (string): Query by specific timestamp.
-- `--timestamp-gte`, `--timestamp-gt`, `--timestamp-lte`, `--timestamp-lt` (string): Timestamp range filters.
-- `--timespan` (string): Timespan unit (default: 'day'). Values: `minute`, `hour`, `day`, `week`, `month`, `quarter`, `year`.
-- `--adjusted` (boolean): Whether to adjust for splits (default: true).
-- `--window` (number): Window size (default: 50).
-- `--series-type` (string): Price type to use. Values: `open`, `high`, `low`, `close`.
-- `--expand-underlying` (boolean): Include underlying aggregates.
-- `--order` (string): Sort order. Values: `asc`, `desc`.
-- `--limit` (number): Max results (default: 10).
-
-**Example:**
-```bash
-bun cli.js forex-sma --ticker C:EURUSD --window 50
-```
-
-### forex-ema
-Get Exponential Moving Average (EMA) for a forex pair.
-
-**Usage:**
-```bash
-bun cli.js forex-ema --ticker <ticker> [options]
-```
-
-**Parameters:**
-- `--ticker` (required): Forex ticker symbol.
-- `--timestamp` (string): Query by specific timestamp.
-- `--timestamp-gte`, `--timestamp-gt`, `--timestamp-lte`, `--timestamp-lt` (string): Timestamp range filters.
-- `--timespan` (string): Timespan unit (default: 'day'). Values: `minute`, `hour`, `day`, `week`, `month`, `quarter`, `year`.
-- `--adjusted` (boolean): Whether to adjust for splits (default: true).
-- `--window` (number): Window size (default: 50).
-- `--series-type` (string): Price type to use. Values: `open`, `high`, `low`, `close`.
-- `--expand-underlying` (boolean): Include underlying aggregates.
-- `--order` (string): Sort order. Values: `asc`, `desc`.
-- `--limit` (number): Max results (default: 10).
-
-**Example:**
-```bash
-bun cli.js forex-ema --ticker C:EURUSD --window 50
-```
-
-### forex-rsi
-Get Relative Strength Index (RSI) for a forex pair.
-
-**Usage:**
-```bash
-bun cli.js forex-rsi --ticker <ticker> [options]
-```
-
-**Parameters:**
-- `--ticker` (required): Forex ticker symbol.
-- `--timestamp` (string): Query by specific timestamp.
-- `--timestamp-gte`, `--timestamp-gt`, `--timestamp-lte`, `--timestamp-lt` (string): Timestamp range filters.
-- `--timespan` (string): Timespan unit (default: 'day'). Values: `minute`, `hour`, `day`, `week`, `month`, `quarter`, `year`.
-- `--adjusted` (boolean): Whether to adjust for splits (default: true).
-- `--window` (number): Window size (default: 14).
-- `--series-type` (string): Price type to use. Values: `open`, `high`, `low`, `close`.
-- `--expand-underlying` (boolean): Include underlying aggregates.
-- `--order` (string): Sort order. Values: `asc`, `desc`.
-- `--limit` (number): Max results (default: 10).
-
-**Example:**
-```bash
-bun cli.js forex-rsi --ticker C:EURUSD --window 14
-```
-
-### forex-macd
-Get Moving Average Convergence/Divergence (MACD) for a forex pair.
-
-**Usage:**
-```bash
-bun cli.js forex-macd --ticker <ticker> [options]
-```
-
-**Parameters:**
-- `--ticker` (required): Forex ticker symbol.
-- `--timestamp` (string): Query by specific timestamp.
-- `--timestamp-gte`, `--timestamp-gt`, `--timestamp-lte`, `--timestamp-lt` (string): Timestamp range filters.
-- `--timespan` (string): Timespan unit (default: 'day'). Values: `minute`, `hour`, `day`, `week`, `month`, `quarter`, `year`.
-- `--adjusted` (boolean): Whether to adjust for splits (default: true).
-- `--short-window` (number): Short window size.
-- `--long-window` (number): Long window size.
-- `--signal-window` (number): Signal window size.
-- `--series-type` (string): Price type to use. Values: `open`, `high`, `low`, `close`.
-- `--expand-underlying` (boolean): Include underlying aggregates.
-- `--order` (string): Sort order. Values: `asc`, `desc`.
-- `--limit` (number): Max results (default: 10).
-
-**Example:**
-```bash
-bun cli.js forex-macd --ticker C:EURUSD
-```
-
-### currency-conversion
-Get currency conversion.
-
-**Usage:**
-```bash
-bun cli.js currency-conversion --from <currency> --to <currency> [options]
-```
-
-**Parameters:**
-- `--from` (required): From currency (e.g., USD).
-- `--to` (required): To currency (e.g., EUR).
-- `--amount` (number): Amount to convert.
-- `--precision` (number): Decimal precision.
-
-**Example:**
-```bash
-bun cli.js currency-conversion --from USD --to EUR --amount 100
-```
-
-### last-forex-quote
-Get the last quote for a forex pair.
-
-**Usage:**
-```bash
-bun cli.js last-forex-quote --from <currency> --to <currency>
-```
-
-**Parameters:**
-- `--from` (required): From currency (e.g., EUR).
-- `--to` (required): To currency (e.g., USD).
-
-**Example:**
-```bash
-bun cli.js last-forex-quote --from EUR --to USD
-```