Cornerstones Docs | Public Beta Overview

Cornerstones Help

Start with help, not a long checklist. The public client is intentionally thin: it teaches the agent where the managed product lives, how to discover current capabilities, and when a real issued API key is required.

python -m pip install cornerstones-client
cornerstones-client --help
cornerstones-client trial start
cornerstones-client guide
cornerstones-client changelog
cornerstones-client auth login --api-key <issued-api-key>
cornerstones-client verify

guide and changelog can use a short-lived discovery trial token when no full API key is present yet. verify is intentionally stricter and requires a real issued API key against /v1/status.

What Cornerstones is

Cornerstones is a managed SaaS market-intelligence plane for agents and operator workflows.

It gives downstream agents and systems a unified surface for:

market facts
market structure
chart artifacts
evidence and event streams
decision-ready context

Authenticated stocks surfaces now include screener, bounded universe presets, optionability checks, earnings, filings, corporate actions, context, indicators, session, chart, and provider-backed depth/tick/imbalance reads.

Recommended workflow

Install the public-safe client with python -m pip install cornerstones-client.
Use cornerstones-client --help and let the agent inspect the command surface before doing anything else.
Read guide and changelog before calling deeper managed surfaces.
When you have an issued key, use cornerstones-client auth login and then cornerstones-client verify.
Use Product Layer Model when you want the five-layer product map, not as the first onboarding page.

Stocks and options workflow

Use the authenticated stocks surfaces as a compact workflow:

Start with stocks screener or bounded stocks universe presets for candidate generation.
Run stocks optionability as a bounded authenticated eligibility read: an authenticated optionability check before options work.
Carry stocks earnings, stocks filings, and stocks corporate-actions forward as event-risk workflow inputs.
Treat stocks depth, stocks tick, and stocks imbalance as provider-backed microstructure snapshots whose provenance, degraded, and fallback fields must be inspected.

Market truth

Quotes, bars, charts, crypto public market reads, stock profiles, options chains, and other asset facts.

Market structure

Bounded orderflow, promoted liquidity metrics, and provider-backed stock microstructure semantics.

Intelligence contract

Macro, cross-asset, sentiment, geopolitics, and other machine-readable interpretation layers.

Evidence and events

Canonical browse or export flows plus alert subscription and delivery workflows.

Agent context

Decision-ready context packages for downstream agents and systems.

Current package truth

Pro means broader authenticated read and context coverage.
Max means narrower premium-depth slices.
Current explicit Pro surfaces include context fx, context gold, cross-asset context, macro series, options chain, options wall, options analysis, and events export.
Current authenticated stocks surfaces include stocks quote, stocks profile, stocks screener, bounded stocks universe presets, stocks optionability, stocks context, stocks indicators, stocks session, stocks chart, stocks earnings, stocks filings, stocks corporate-actions, stocks depth, stocks tick, and stocks imbalance.
Current bounded universe presets are us-stocks-liquid, us-stocks-large-cap, us-etfs-core, and us-stocks-non-etf.
stocks screener and stocks universe are bounded candidate-generation surfaces, not an unlimited market export plane.
stocks optionability is a bounded authenticated eligibility check, not a casual symbol metadata guess.
Treat stocks earnings, stocks filings, and stocks corporate-actions as event-risk workflow inputs, not random extras.
Treat stocks depth, stocks tick, and stocks imbalance as provider-backed microstructure snapshots, not unlimited historical feeds.
Current crypto coverage is public market data only: quote, bars, depth snapshot, recent trades, ticker, session, and indicators. It does not include private account or order surfaces.
Current explicit Max surface is orderflow liquidity-metrics.
Orderflow liquidity-metrics is the promoted support surface; raw, summary, context, and historical keep explicit scope and readiness semantics.
Baseline reads such as quotes, bars, charts, crypto public reads, events recent/history, and the normal alerts subscription path are not by themselves premium-depth claims.
Website pricing labels default to the core runtime limits: Free $0/mo at 1,000 requests/month and 10 requests/minute, Pro $29/mo at 10,000 requests/month and 60 requests/minute, and Max $59/mo with custom/unlimited request ceilings. These display values and feature lists are configurable by environment.

Current onboarding boundary

Current public-safe onboarding defaults to the same two-line local-client flow shown on the homepage:

install cornerstones-client from PyPI
run cornerstones-client --help
let the agent choose any next command from the help output

cornerstones-client auth login stores the key in the local client config. It is not the same thing as a browser sign-in or hosted account session.

verify still requires a real issued API key against /v1/status.

Beta boundaries

Cornerstones public beta keeps these truths explicit:

managed SaaS only
some surfaces are still scoped
some higher-intensity surfaces remain premium-depth or limited-access
some surfaces may return truthful degraded, fallback, not_implemented, or unavailable states instead of pretending a deeper live surface exists
hosted login, dashboard, and billing checkout now exist on the managed portal, but this overview still does not claim a fully open self-serve rollout or final public pricing table