cornerstones-client 0.1.23

Public-safe Cornerstones client CLI for managed market context access

Cornerstones Client

cornerstones-client is the customer-facing CLI for the managed Cornerstones Core API.

It exposes customer-safe read surfaces plus customer-owned alert/event subscription create/delete flows. It intentionally does not expose admin/operator/internal/destructive flows such as alert dispatch/replay/resolve/test, event receipt submission/export, order-flow collection jobs, or maintenance jobs.

Current documented release: 0.1.23.

Install

python -m pip install -U cornerstones-client==0.1.23

Requirements:

• Python >=3.11
• network access to the hosted Core API for no-key public/basic reads, plus an issued Cornerstones API key for verification, Free quota, and premium surfaces
• network access to https://api.usecornerstones.com

Access matrix

No-key public access includes selected basic market reads. No-key/trial access is not discovery-only: guide plus selected public market reads work before durable account access, while verify / /v1/status requires a real issued API key and /v1/changelog is admin-only. Free keys are limited to 500 requests/month and 10 requests/minute. Charts require Pro+. Orderflow requires Max. See docs/ACCESS_MATRIX.md for the canonical customer-facing matrix.

Login

cornerstones-client auth login --api-key <issued-api-key>
cornerstones-client verify

Typed Python client

Use CornerstonesClient when code needs typed, shape-preserving access to customer-safe read surfaces:

import os

from cornerstones_client import CornerstonesClient

client = CornerstonesClient(api_key=os.environ["CORNERSTONES_API_KEY"])

bars = client.fx.bars("XAUUSD", timeframe="M15", bars=128)
levels = client.fx.levels("XAUUSD")
opening_range = client.fx.opening_range("XAUUSD", session="london", minutes=30)
price_action = client.fx.price_action("XAUUSD", timeframe="H1", bars=120)
volume_profile = client.fx.volume_profile("XAUUSD", timeframe="15m", basis="gc_futures")
event_window = client.macro.event_window("XAUUSD", currency="USD", importance="high")

Typed wrappers preserve Core contract metadata: as_of, freshness_status, degraded, fallback, and provenance; XAU volume-profile wrappers also preserve proxy, source_symbol, basis, and profile_quality. Use .to_dict() for full raw payload access, including future fields.

Safety boundary: these methods expose read-only market structure and macro context only. They grant no trading recommendation, account, risk, or execution permissions. XAU volume profile is a GC futures proxy, not spot centralized volume.

Do not paste real keys into shared logs. For webhook signing secrets, use env vars:

export CLIENT_SIGNING_SECRET='...'
cornerstones-client alerts subscribe \
  --asset XAUUSD \
  --lane x_pressure \
  --webhook-url https://client.example.com/cornerstones/alerts \
  --signing-secret-env CLIENT_SIGNING_SECRET \
  --yes

Full exposed command list

• auth status
• auth login
• auth logout
• auth set-base-url
• auth set-api-base-url
• trial start
• trial status
• trial token
• guide
• changelog
• verify
• fx quote
• fx bars
• fx indicators
• fx session
• fx levels
• fx opening-range
• fx price-action
• fx volume-profile
• fx options-proxy
• fx positioning
• context fx
• context gold
• context stocks
• orderflow summary (Max)
• orderflow context (Max)
• orderflow raw (Max)
• orderflow historical (Max)
• orderflow liquidity-metrics (Max)
• chart fx (Pro+) — returns Core-rendered artifact URLs/manifest; public output uses cornerstones_chart_renderer labels.
• chart stocks (Pro+) — supports intermarket/context bundles when Core has explicit benchmark mappings.
• crypto quote
• crypto ticker
• crypto bars
• crypto indicators
• crypto session
• crypto depth
• crypto trades
• stocks quote
• stocks profile
• stocks optionability
• stocks context
• stocks indicators
• stocks session
• stocks depth
• stocks imbalance
• stocks imbalance-window
• stocks tick
• stocks earnings
• stocks filings
• stocks facts
• stocks transcripts
• stocks analyst-estimates
• stocks ratings
• stocks price-targets
• stocks ratios
• stocks key-metrics
• stocks research-context
• stocks extended-hours
• stocks corporate-actions
• stocks screener
• stocks universe
• stocks normalize-symbol
• stocks exchanges
• options chain
• options analysis
• options wall
• macro summary
• macro yields
• macro series
• macro calendar
• macro event-window
• geopolitics context
• geopolitics status
• geopolitics watchlist
• geopolitics pizza-index
• geopolitics evidence
• geopolitics osint-feed
• geopolitics polymarket
• polymarket overview
• polymarket context
• events recent
• events history
• events receipts
• events subscribe
• events delete
• cross-asset
• evidence feed
• alerts metrics
• alerts recent
• alerts dead-letter
• alerts list
• alerts history
• alerts security-status
• alerts show
• alerts subscribe
• alerts delete

Response contract

Most commands print JSON. Common fields:

• degraded: false means required/core path was healthy. Optional upstream-empty components may still be marked available=false inside nested objects.
• fallback: present when Core API had to use fallback/degraded behavior.
• provenance / data_quality: source and freshness metadata.
• subscription responses redact secret-like fields as [REDACTED].

Full command examples

Auth / local config

auth status

Command:

cornerstones-client auth status

Example output (redacted / shape-preserving):

{"portal_base_url":"https://www.usecornerstones.com","api_base_url":"https://api.usecornerstones.com","logged_in":true,"has_trial_cookie":false,"has_trial_token":false}

auth login

Command:

cornerstones-client auth login --api-key <issued-api-key>

Example output (redacted / shape-preserving):

{"logged_in":true,"api_base_url":"https://api.usecornerstones.com"}

auth logout

Command:

cornerstones-client auth logout

Example output (redacted / shape-preserving):

{"logged_out":true}

auth set-base-url

Command:

cornerstones-client auth set-base-url --base-url https://www.usecornerstones.com

Example output (redacted / shape-preserving):

{"saved":true,"portal_base_url":"https://www.usecornerstones.com"}

auth set-api-base-url

Command:

cornerstones-client auth set-api-base-url --api-base-url https://api.usecornerstones.com

Example output (redacted / shape-preserving):

{"saved":true,"api_base_url":"https://api.usecornerstones.com"}

Trial / discovery

trial start

Command:

cornerstones-client trial start

Example output (redacted / shape-preserving):

{"trial":{"status":"active","remaining_requests":50},"token":{"expires_at":"2026-04-29T00:00:00Z"}}

trial status

Command:

cornerstones-client trial status

Example output (redacted / shape-preserving):

{"status":"active","remaining_requests":49,"expires_at":"2026-04-29T00:00:00Z"}

trial token

Command:

cornerstones-client trial token

Example output (redacted / shape-preserving):

{"token":{"token":"[REDACTED]","expires_at":"2026-04-29T00:00:00Z"}}

guide

Command:

cornerstones-client guide

Example output (redacted / shape-preserving):

{"product":"cornerstones","surface_count":70,"features":[{"name":"fx","status":"available"}]}

changelog

Command:

cornerstones-client changelog

Access: admin-only Core changelog route. Public users should use website release notes instead of treating /v1/changelog as no-key discovery.

Example output (redacted / shape-preserving):

{"versions":[{"version":"0.1.9","highlights":["complete customer CLI documentation"]}]}

Verification

verify

Command:

cornerstones-client verify

Example output (redacted / shape-preserving):

{"ok":true,"authenticated":true,"plan":"admin","scopes":["read","write","admin"]}

FX

fx quote

Command:

cornerstones-client fx quote --symbol EURUSD

Example output (redacted / shape-preserving):

{"symbol":"EURUSD","bid":1.1609,"ask":1.1611,"mid":1.1610,"degraded":false,"provenance":"runtime"}

fx bars

Command:

cornerstones-client fx bars --symbol EURUSD --timeframe 1h --count 3

Example output (redacted / shape-preserving):

{"symbol":"EURUSD","timeframe":"1h","count":3,"bars":[{"time":"2026-04-28T04:00:00Z","open":1.1604,"high":1.1614,"low":1.1600,"close":1.1610}]}

fx indicators

Command:

cornerstones-client fx indicators --symbol USDJPY --timeframe H1 --bars 50

Example output (redacted / shape-preserving):

{"symbol":"USDJPY","timeframe":"H1","indicators":{"rsi14":54.2,"ema20":156.41},"degraded":false}

fx session

Command:

cornerstones-client fx session --symbol XAUUSD --timeframe H1 --bars 80

Example output (redacted / shape-preserving):

{"symbol":"XAUUSD","session":"london","range":{"high":2348.2,"low":2339.1},"degraded":false}

fx levels

Command:

cornerstones-client fx levels --symbol EURUSD --timeframe 5m --bars 600

Example output (redacted / shape-preserving):

{"symbol":"EURUSD","timeframe":"5m","levels":{"previous_day_high":1.1620,"session_low":1.1588},"provenance":"fx_bars","degraded":false}

fx opening-range

Command:

cornerstones-client fx opening-range --symbol EURUSD --session london --minutes 30

Example output (redacted / shape-preserving):

{"symbol":"EURUSD","session":"london","minutes":30,"opening_range":{"high":1.1618,"low":1.1599},"degraded":false}

fx price-action

Command:

cornerstones-client fx price-action --symbol XAUUSD --timeframe H1 --bars 120

Example output (redacted / shape-preserving):

{"symbol":"XAUUSD","timeframe":"H1","structure":{"trend":"range","last_swing":"higher_low"},"degraded":false}

fx volume-profile

Command:

cornerstones-client fx volume-profile --symbol XAUUSD --timeframe 15m --basis gc_futures

Example output (redacted / shape-preserving):

{"symbol":"XAUUSD","source_symbol":"GC","basis":"gc_futures","proxy":true,"profile_quality":"usable","poc":2350.5,"vah":2356.0,"val":2344.0,"provenance":"gc_futures_orderflow_proxy","degraded":false}

Note: this is GC futures orderflow proxy evidence for XAUUSD, not centralized spot volume. Use profile_quality, degraded, and fallback before consuming POC/VAH/VAL.

fx options-proxy

Command:

cornerstones-client fx options-proxy --symbol EURUSD

Example output (redacted / shape-preserving):

{"symbol":"EURUSD","proxy":true,"experimental":true,"proxy_symbols":["FXE"],"proxy_formula":"FXE ETF options as EURUSD volatility proxy; not OTC FX options truth","native_otc_fx_options_available":false,"components":[{"proxy_symbol":"FXE","role":"euro_etf_options","analysis":{},"degraded":false}],"provenance":"options_service","degraded":false,"data_quality":{"proxy_evidence_only":true,"component_count":1}}

fx positioning

Command:

cornerstones-client fx positioning --symbol EURUSD

Example output (redacted / shape-preserving):

{"symbol":"EURUSD","proxy":true,"experimental":true,"components":{"cot":{"available":false,"status":"provider_missing"},"futures_oi":{"available":false,"status":"provider_missing"},"retail_positioning":{"available":false,"status":"provider_missing"},"broker_flow":{"available":false,"status":"provider_missing"}},"provenance":"none","degraded":false,"fallback":"positioning_providers_missing","data_quality":{"neutral_positioning_inferred":false}}

Context

context fx

Command:

cornerstones-client context fx --symbol XAUUSD --timeframe 1h --count 5

Example output (redacted / shape-preserving):

{"symbol":"XAUUSD","context":{"quote":{},"macro":{},"correlation_evidence":{}},"degraded":false}

context gold

Command:

cornerstones-client context gold --symbol XAUUSD --timeframe 1h --count 5

Example output (redacted / shape-preserving):

{"symbol":"XAUUSD","market":"gold","context":{"futures_proxy":"GC","fx_quote":{}},"degraded":false}

context stocks

Command:

cornerstones-client context stocks --symbol AAPL --timeframe 1d --count 5

Example output (redacted / shape-preserving):

{"symbol":"AAPL","context":{"quote":{},"profile":{},"options":{}},"degraded":false}

Orderflow

orderflow summary

Command:

cornerstones-client orderflow summary --symbol XAUUSD

Example output (redacted / shape-preserving):

{"symbol":"XAUUSD","summary":{"book_pressure_direction":"neutral"},"raw_observations":{},"derived_features":{},"readiness":{"data_contract_ready":true},"degraded":false}

orderflow context

Command:

cornerstones-client orderflow context --symbol XAUUSD

Example output (redacted / shape-preserving):

{"symbol":"XAUUSD","orderflow_context":{"state":"balanced"},"raw_observations":{},"derived_features":{},"readiness":{"data_contract_ready":true},"degraded":false}

orderflow raw

Command:

cornerstones-client orderflow raw --symbol XAUUSD

Example output (redacted / shape-preserving):

{"symbol":"XAUUSD","market_data":{"bids":[],"asks":[]},"data_quality_status":"ok","degraded":false}

orderflow historical

Command:

cornerstones-client orderflow historical --symbol XAUUSD

Example output (redacted / shape-preserving):

{"symbol":"XAUUSD","count":20,"items":[{"asof":"2026-04-28T04:00:00Z","imbalance":0.08}]}

orderflow liquidity-metrics

Command:

cornerstones-client orderflow liquidity-metrics --symbol XAUUSD

Example output (redacted / shape-preserving):

{"symbol":"XAUUSD","metrics":{"spread":0.2,"breakout_acceptance_score":0.65},"readiness":{"data_contract_ready":true},"degraded":false}

Chart

chart fx

Command:

cornerstones-client chart fx --symbol XAUUSD --timeframe H1 --bars 120 --indicator rsi

Example output (redacted / shape-preserving):

{"symbol":"XAUUSD","engine":"cornerstones_chart_renderer","image_url":"https://api.usecornerstones.com/artifacts/chart_xxx.png","manifest_url":"https://api.usecornerstones.com/artifacts/chart_xxx.json","degraded":false}

chart stocks

Command:

cornerstones-client chart stocks --symbol AAPL --timeframe 1d --bars 80

Example output (redacted / shape-preserving):

{"symbol":"AAPL","engine":"cornerstones_chart_renderer","image_url":"https://api.usecornerstones.com/artifacts/chart_xxx.png","degraded":false,"warnings":[]}

Crypto

crypto quote

Command:

cornerstones-client crypto quote --symbol BTCUSD

Example output (redacted / shape-preserving):

{"symbol":"BTCUSD","bid":94480.1,"ask":94491.2,"mid":94485.6,"degraded":false}

crypto ticker

Command:

cornerstones-client crypto ticker --symbol BTCUSD

Example output (redacted / shape-preserving):

{"symbol":"BTCUSD","last":94485.6,"volume_24h":12345.0,"degraded":false}

crypto bars

Command:

cornerstones-client crypto bars --symbol BTCUSD --timeframe 1h --count 3

Example output (redacted / shape-preserving):

{"symbol":"BTCUSD","timeframe":"1h","count":3,"bars":[{"time":"2026-04-28T04:00:00Z","close":94485.6}]}

crypto indicators

Command:

cornerstones-client crypto indicators --symbol BTCUSD --timeframe 1h --bars 50

Example output (redacted / shape-preserving):

{"symbol":"BTCUSD","indicators":{"rsi14":51.8,"ema20":94210.4},"degraded":false}

crypto session

Command:

cornerstones-client crypto session --symbol BTCUSD --timeframe 1h --bars 80

Example output (redacted / shape-preserving):

{"symbol":"BTCUSD","session":"global","range":{"high":95120.0,"low":93880.5},"degraded":false}

crypto depth

Command:

cornerstones-client crypto depth --symbol BTCUSD --limit 5

Example output (redacted / shape-preserving):

{"symbol":"BTCUSD","bids":[[94480.0,1.2]],"asks":[[94491.0,0.9]],"degraded":false}

crypto trades

Command:

cornerstones-client crypto trades --symbol BTCUSD --limit 5

Example output (redacted / shape-preserving):

{"symbol":"BTCUSD","trades":[{"price":94485.6,"size":0.12,"side":"buy"}],"degraded":false}

Stocks

stocks quote

Command:

cornerstones-client stocks quote --symbol AAPL

Example output (redacted / shape-preserving):

{"symbol":"AAPL","price":214.7,"currency":"USD","degraded":false,"provenance":"core"}

stocks profile

Command:

cornerstones-client stocks profile --symbol AAPL

Example output (redacted / shape-preserving):

{"symbol":"AAPL","company_name":"Apple Inc.","exchange":"NASDAQ","sector":"Technology"}

stocks optionability

Command:

cornerstones-client stocks optionability --symbol AAPL

Example output (redacted / shape-preserving):

{"symbol":"AAPL","optionable":true,"degraded":false,"reason":null}

stocks context

Command:

cornerstones-client stocks context --symbol AAPL --bars-count 5

Example output (redacted / shape-preserving):

{"symbol":"AAPL","context":{"quote":{},"extended_hours":{"data":{"provider_session_scope":"combined_extended_hours","observed_session":"after_hours","last_trade_price":189.1}},"profile":{},"optionability":{}},"degraded":false}

stocks extended-hours

Command:

cornerstones-client stocks extended-hours --symbol AAPL --session extended
cornerstones-client stocks extended-hours --symbol AAPL --session pre-market
cornerstones-client stocks extended-hours --symbol AAPL --session after-hours

Example output (redacted / shape-preserving):

{"symbol":"AAPL","surface":"stocks_extended_hours","items":[{"provider_session_scope":"combined_extended_hours","observed_session":"after_hours","bid_price":189.0,"ask_price":189.2,"extended_mid_price":189.1,"last_trade_price":189.12}],"degraded":false}

The upstream extended-hours quote/trade source reports a combined extended-hours scope. Use requested_session plus observed_session; do not assume separate pre-market vs after-hours endpoint semantics.

stocks indicators

Command:

cornerstones-client stocks indicators --symbol AAPL --timeframe 1d --bars 80

Example output (redacted / shape-preserving):

{"symbol":"AAPL","timeframe":"1d","indicators":{"rsi14":57.3,"sma20":211.4},"degraded":false}

stocks session

Command:

cornerstones-client stocks session --symbol AAPL --timeframe 1d --bars 80

Example output (redacted / shape-preserving):

{"symbol":"AAPL","session":"regular","range":{"high":216.2,"low":212.5},"degraded":false}

stocks depth

Command:

cornerstones-client stocks depth --symbol AAPL --num-rows 5

Example output (redacted / shape-preserving):

{"symbol":"AAPL","rows":[{"bid":214.68,"ask":214.72,"bid_size":100,"ask_size":100}],"degraded":false}

stocks imbalance

Command:

cornerstones-client stocks imbalance --symbol AAPL --exchange NYSE

Example output (redacted / shape-preserving):

{"symbol":"AAPL","exchange":"NYSE","imbalance_quantity":1200,"raw_observation":{"provider":"market_data_provider","exchange":"NYSE"},"derived_features":{"signed_imbalance_quantity":1200,"pressure_direction":"buy_pressure"},"data_quality":{"field_maturity":"snapshot_only"},"readiness":{"data_contract_ready":true},"degraded":false}

stocks imbalance-window

Command:

cornerstones-client stocks imbalance-window --symbol AAPL --exchange NYSE --window-minutes 30

Example output (redacted / shape-preserving):

{"symbol":"AAPL","exchange":"NYSE","window_minutes":30,"sample_count":3,"observations":[{"as_of":"2026-05-26T13:30:00Z","imbalance_side":"buy","imbalance_quantity":1200}],"trend_features":{"side_transitions":0,"max_imbalance_quantity":1200,"signed_imbalance_change":0},"data_quality":{"field_maturity":"rolling_window","retention_mode":"in_memory"},"readiness":{"data_contract_ready":true},"degraded":false}

stocks imbalance-window exposes auction imbalance rolling window facts only: raw observations, derived numeric features, data quality, and data-contract readiness. It does not provide trade signals or production/trading authority.

stocks tick

Command:

cornerstones-client stocks tick --symbol AAPL --tick-type Last --num-ticks 10

Example output (redacted / shape-preserving):

{"symbol":"AAPL","tick_type":"Last","ticks":[{"time":"2026-04-28T13:30:01Z","price":214.7}]}

stocks earnings

Command:

cornerstones-client stocks earnings --symbol AAPL --from 2026-04-01 --to 2026-06-30

Example output (redacted / shape-preserving):

{"symbol":"AAPL","count":1,"events":[{"date":"2026-05-01","status":"confirmed"}],"degraded":false}

stocks filings

Command:

cornerstones-client stocks filings --symbol AAPL --provider sec --form 10-Q --limit 3

Example output (redacted / shape-preserving):

{"symbol":"AAPL","provider":"sec","limit":3,"filings":[{"form_type":"10-Q","filed_at":"2026-04-25T00:00:00Z","url":"https://www.sec.gov/Archives/..."}],"data_quality":{"official_source":true},"degraded":false}

stocks facts

Command:

cornerstones-client stocks facts --symbol AAPL --provider sec --period annual --limit 5

Example output (redacted / shape-preserving):

{"symbol":"AAPL","provider":"sec","period":"annual","facts":[{"concept":"Revenues","unit":"USD","value":391035000000,"fiscal_period":"FY"}],"data_quality":{"official_source":true},"degraded":false}

stocks corporate-actions

Command:

cornerstones-client stocks corporate-actions --symbol AAPL --type all

Example output (redacted / shape-preserving):

{"symbol":"AAPL","actions":[{"type":"dividend","ex_date":"2026-05-10"}],"degraded":false}

stocks screener

Command:

cornerstones-client stocks screener --market-cap-more-than 10000000000 --limit 5

Example output (redacted / shape-preserving):

{"count":5,"rows":[{"symbol":"AAPL","marketCap":3000000000000}],"degraded":false}

stocks universe

Command:

cornerstones-client stocks universe --preset us-stocks-liquid --limit 5

Example output (redacted / shape-preserving):

{"preset":"us-stocks-liquid","count":5,"symbols":["AAPL","MSFT","NVDA"],"degraded":false}

China A-share examples

Current A-share support uses provider-native suffixes and exchange codes:

cornerstones-client stocks quote --symbol 600519.SS
cornerstones-client stocks quote --symbol 000001.SZ
cornerstones-client stocks screener --exchange SHH --limit 25
cornerstones-client stocks screener --exchange SHZ --limit 25
cornerstones-client stocks universe --preset china-a-shares-largecap --limit 25
cornerstones-client stocks normalize-symbol --symbol 600519.SH
cornerstones-client stocks exchanges

Contracts:

• Shanghai quote/profile/bars symbols use .SS; .SH is normalized to .SS by Core.
• Shenzhen quote/profile/bars symbols use .SZ.
• Screener exchange codes are SHH and SHZ.
• Beijing/BSE .BJ is explicitly unsupported in the current public phase; later China-specific enrichment can add BJ metadata and adjusted bars.

Options

Options are read-only market-truth surfaces. Cornerstones/client expose chain, wall, and analysis data only; they do not expose BAG/ComboLeg construction, what-if, order submit/cancel, risk, or reconciliation.

options chain

Command:

cornerstones-client options chain --symbol AAPL --max-expirations 1 --include quote,greeks,oi,volume,iv

Aliases:

• --expiration and --expiration-date

Example output (redacted / shape-preserving):

{"chain":{"underlying_symbol":"AAPL","sec_type":"OPT","underlying_type":"STK","total_contracts":12,"quality_metadata":{"contract_count":12,"contracts_with_bid_ask":10,"contracts_with_greeks":8,"contracts_with_volume":6,"contracts_with_open_interest":12},"contracts":[{"sec_type":"OPT","option_type":"call","strike":215.0,"expiration_date":"2026-05-15T00:00:00","underlying_type":"STK","has_bid_ask":true,"has_mid":true,"has_greeks":true,"has_volume":true,"has_open_interest":true}],"degraded":false,"provenance":"cornerstones_options_primary"},"provenance":"cornerstones_options_primary","degraded":false,"fallback":null}

options analysis

Command:

cornerstones-client options analysis --symbol AAPL --expiration 2026-05-15

Example output (redacted / shape-preserving):

{"analysis":{"underlying_symbol":"AAPL","put_call_ratio":2.506,"max_pain_strike":265.0,"degraded":false,"provenance":"cornerstones_options_primary","data_quality":{"chain_quality":{"contract_count":12,"contracts_with_greeks":8}}},"message":"Options analysis for AAPL"}

options wall

Command:

cornerstones-client options wall --symbol AAPL --threshold 90

Aliases:

• --threshold and --threshold-percentile
• --expiration and --expiration-date

Example output (redacted / shape-preserving):

{"wall":{"underlying_symbol":"AAPL","call_walls":[{"strike":250.0,"open_interest":1200,"volume":300,"percentile":95.0}],"put_walls":[],"degraded":false,"provenance":"cornerstones_options_primary","data_quality":{"wall_metric":"open_interest","has_open_interest_data":true}},"message":"Options wall analysis for AAPL"}

Macro

macro summary

Command:

cornerstones-client macro summary

Example output (redacted / shape-preserving):

{"summary":{"risk_calendar":"normal","next_high_importance_event":"FOMC"},"degraded":false}

macro yields

Command:

cornerstones-client macro yields

Example output (redacted / shape-preserving):

{"curves":{"US10Y":4.62,"US2Y":4.91},"degraded":false}

macro series

Command:

cornerstones-client macro series --name dxy

Example output (redacted / shape-preserving):

{"name":"dxy","count":100,"observations":[{"time":"2026-04-28","value":105.2}],"degraded":false}

macro calendar

Command:

cornerstones-client macro calendar --country US --importance high

Example output (redacted / shape-preserving):

{"count":3,"events":[{"time":"2026-04-30T12:30:00Z","country":"US","event":"GDP","importance":"high"}]}

macro event-window

Command:

cornerstones-client macro event-window --symbol XAUUSD --currency USD --importance high --lookback-minutes 60 --lookahead-minutes 240

Example output (redacted / shape-preserving):

{"symbol":"XAUUSD","currency":"USD","event_window_state":"near_high_importance_event","blackout_suggestion":"caution","events":[{"event":"FOMC","importance":"high"}],"provenance":"cornerstones_macro","degraded":false}

Note: macro event windows are objective risk-context evidence only. They are not execution recommendations.

Geopolitics / OSINT

geopolitics context

Command:

cornerstones-client geopolitics context

Example output (redacted / shape-preserving):

{"context":{"risk_level":"medium","drivers":[]},"degraded":false}

geopolitics status

Command:

cornerstones-client geopolitics status

Example output (redacted / shape-preserving):

{"status":"ok","feeds":{"osint":"available","pizza_index":"available"},"degraded":false}

geopolitics watchlist

Command:

cornerstones-client geopolitics watchlist

Example output (redacted / shape-preserving):

{"watchlist":[{"region":"Middle East","priority":"medium"}],"degraded":false}

geopolitics pizza-index

Command:

cornerstones-client geopolitics pizza-index

Example output (redacted / shape-preserving):

{"pizza_index":{"status":"normal","signal":"baseline"},"degraded":false}

geopolitics evidence

Command:

cornerstones-client geopolitics evidence --min-priority medium

Example output (redacted / shape-preserving):

{"count":5,"evidence":[{"priority":"medium","summary":"..."}],"degraded":false}

geopolitics osint-feed

Command:

cornerstones-client geopolitics osint-feed --limit 5 --min-priority medium

Example output (redacted / shape-preserving):

{"count":5,"items":[{"source":"osint","priority":"medium","headline":"..."}],"degraded":false}

geopolitics polymarket

Command:

cornerstones-client geopolitics polymarket --limit 5 --keyword election

Example output (redacted / shape-preserving):

{"count":5,"markets":[{"question":"...","probability":0.42}],"degraded":false}

Polymarket

polymarket overview

Command:

cornerstones-client polymarket overview

Example output (redacted / shape-preserving):

{"overview":{"market_count":120,"top_themes":["macro","election"]},"degraded":false}

polymarket context

Command:

cornerstones-client polymarket context

Example output (redacted / shape-preserving):

{"context":{"markets":[],"risk_themes":[]},"degraded":false}

Events

events recent

Command:

cornerstones-client events recent --symbol XAUUSD --limit 5

Example output (redacted / shape-preserving):

{"count":5,"events":[{"event_id":"evt_example","event_family":"scheduled_macro","severity":"medium","affected_symbols":["XAUUSD"]}],"degraded":false}

events history

Command:

cornerstones-client events history --family scheduled_macro --limit 5

Example output (redacted / shape-preserving):

{"count":5,"events":[{"event_id":"evt_example","event_family":"scheduled_macro"}],"has_more":false}

events receipts

Command:

cornerstones-client events receipts --limit 5

Example output (redacted / shape-preserving):

{"count":0,"receipts":[],"degraded":false}

events subscribe

Command:

cornerstones-client events subscribe --symbol XAUUSD --family scheduled_macro --webhook-url https://client.example.com/cornerstones/events --signing-secret-env CLIENT_SIGNING_SECRET --yes

Example output (redacted / shape-preserving):

{"subscription":{"subscription_id":"sub_example","status":"active","filters":{"symbol":"XAUUSD","family":"scheduled_macro"},"delivery":{"signing_secret":"[REDACTED]"}},"bootstrap":{"mode":"snapshot"}}

events delete

Command:

cornerstones-client events delete --subscription-id sub_example --yes

Example output (redacted / shape-preserving):

{"deleted":true,"subscription_id":"sub_example","status":"deleted"}

Cross-asset

cross-asset

Command:

cornerstones-client cross-asset

Example output (redacted / shape-preserving):

{"context":{"fx":{},"gold":{},"stocks":{},"crypto":{},"macro":{}},"degraded":false}

Evidence

evidence feed

Command:

cornerstones-client evidence feed --limit 5 --asset XAUUSD

Example output (redacted / shape-preserving):

{"count":5,"items":[{"evidence_id":"ev_example","asset":"XAUUSD","source":"alerts_store","priority":"medium"}],"degraded":false,"not_implemented":false}

Alerts

alerts metrics

Command:

cornerstones-client alerts metrics

Example output (redacted / shape-preserving):

{"subscriptions":{"active":1,"total":1},"deliveries":{"dead_letter":0,"failed":0},"degraded":false}

alerts recent

Command:

cornerstones-client alerts recent --limit 5

Example output (redacted / shape-preserving):

{"count":3,"deliveries":[{"delivery_id":"del_example","status":"delivered","subscription_id":"sub_example"}],"degraded":false}

alerts dead-letter

Command:

cornerstones-client alerts dead-letter --limit 5

Example output (redacted / shape-preserving):

{"count":0,"items":[],"degraded":false}

alerts list

Command:

cornerstones-client alerts list --status active

Example output (redacted / shape-preserving):

{"count":1,"subscriptions":[{"subscription_id":"sub_example","status":"active","assets":["XAUUSD"]}]}

alerts history

Command:

cornerstones-client alerts history --asset XAUUSD --limit 5

Example output (redacted / shape-preserving):

{"count":5,"items":[{"subscription_id":"sub_example","lane":"x_pressure","lifecycle":"delivered"}]}

alerts security-status

Command:

cornerstones-client alerts security-status --subscription-id sub_example

Example output (redacted / shape-preserving):

{"subscription_id":"sub_example","security":{"require_signing":true,"headers_redacted":true}}

alerts show

Command:

cornerstones-client alerts show --subscription-id sub_example

Example output (redacted / shape-preserving):

{"subscription":{"subscription_id":"sub_example","status":"active","delivery":{"signing_secret":"[REDACTED]"}}}

alerts subscribe

Command:

cornerstones-client alerts subscribe --asset XAUUSD --lane x_pressure --webhook-url https://client.example.com/cornerstones/alerts --signing-secret-env CLIENT_SIGNING_SECRET --yes

Example output (redacted / shape-preserving):

{"subscription":{"subscription_id":"sub_example","status":"active","assets":["XAUUSD"],"lanes":["x_pressure"],"delivery":{"signing_secret":"[REDACTED]"}},"bootstrap":{"mode":"snapshot"}}

alerts delete

Command:

cornerstones-client alerts delete --subscription-id sub_example --yes

Example output (redacted / shape-preserving):

{"deleted":true,"subscription_id":"sub_example","status":"deleted"}

Excluded from public client

Not exposed by design:

• admin/operator endpoints
• internal maintenance jobs
• order-flow collection/admin jobs
• alert dispatch/replay/resolve/test
• event receipt submit/export
• destructive state mutations beyond customer-owned subscription create/delete
• direct binary artifact download helpers; chart commands return artifact URLs/metadata instead

Troubleshooting

• not_logged_in: run cornerstones-client auth login --api-key <issued-api-key>.
• missing_signing_secret: set env var named by --signing-secret-env.
• confirmation_required: add --yes for subscription create/delete.
• 401 / 403: key missing, expired, or lacks required scope.
• degraded=true: inspect fallback and data_quality; this is provider/runtime truth, not a client crash.