Massive.com CLI

Bash CLI wrapper and OpenClaw skill for Massive's public REST API. Use when Codex or an OpenClaw agent needs to query Massive market-data endpoints from a sh...

Massive CLI for OpenClaw

Use the bundled CLI before writing ad hoc curl commands. Keep requests deterministic, resolve credentials through OpenClaw-compatible secret references when available, and prefer narrow queries over broad scans.

Quick Start

• Read references/openclaw-secrets.md before configuring credentials.
• Read references/massive-api.md when choosing endpoints or query shapes.
• Read references/security.md before changing logging, auth, or error handling.
• Run scripts/massive health to validate local prerequisites and auth configuration.
• Run scripts/massive get /v3/reference/tickers/AAPL for a generic REST request.
• If you package or publish this skill, include every path listed in BUNDLE_MANIFEST.md.

Workflow

1. Resolve credentials through MASSIVE_API_KEY_REF when possible.
2. Fall back to MASSIVE_API_KEY only when a secret ref is not available.
3. Use a domain shortcut when it matches a documented Massive endpoint.
4. Use get for any other documented REST path.
5. Pipe JSON into downstream tools instead of enabling verbose logging.

Commands

• scripts/massive health
• scripts/massive get <path-or-next-url> [--query key=value ...]
• scripts/massive next to read next_url from stdin JSON and fetch the next page
• scripts/massive stocks ticker-details <ticker>
• scripts/massive stocks previous-close <ticker>
• scripts/massive options contract-details <options-ticker>
• scripts/massive forex currencies
• scripts/massive crypto currencies
• scripts/massive indices ticker-details <ticker>

Agent Rules

• Keep output in JSON unless a human-readable mode is explicitly needed.
• Send diagnostics to stderr; treat stdout as data.
• Never print resolved secrets, auth headers, or raw secret-ref payloads.
• Avoid --verbose in shared logs.
• Feed next_url back into get or next instead of reconstructing pagination manually.
• Treat non-api.massive.com absolute URLs as invalid unless MASSIVE_BASE_URL was explicitly changed to another HTTPS origin.

Resources

• scripts/massive: main Bash CLI
• BUNDLE_MANIFEST.md: required file list for packaged artifacts
• references/openclaw-secrets.md: credential and secret-ref contract used by this skill
• references/massive-api.md: endpoint selection and request patterns
• references/security.md: redaction and operational safety constraints