Documentation

Context Packets

Decision-ready JSON packets that combine price, event, and evidence layers.

Copy this to your agent Help first
python -m pip install cornerstones-client
cornerstones-client --help
cornerstones-client guide
Context Packets Customer guide

At a glance

Context packets are the core Cornerstones product shape: bounded JSON that combines market truth, chart evidence, event context, and quality signals before an agent reasons or acts.

Commands

CommandCopyable
cornerstones-client context gold --symbol XAUUSD --timeframe 1h --count 3
cornerstones-client context fx --symbol EURUSD --timeframe 1h --count 3
cornerstones-client context stocks --symbol AAPL --timeframe 1d --count 5
cornerstones-client cross-asset context --symbol XAUUSD

What to ask

  • What is observable now?
  • What recent evidence matters?
  • Are there chart, event, or order-flow surfaces that should change confidence?
  • Is any requested surface unavailable for this account?

Live response

Captured from a live Cornerstones API response on 2026-05-07T13:21Z. The capture key is not shown. Source details are normalized to Cornerstones labels.

JSON responseCopyable
{
  "context": {
    "xauusd_spot": 4742.41,
    "xauusd_timestamp": "2026-05-07T16:21:52+01:00",
    "gc_futures_front": 4746.1,
    "gc_futures_month": "2026-04",
    "gld_price": 430.96,
    "gdx_price": 92.44,
    "sentiment_score": 0.098,
    "narrative_summary": "Gold showing neutral sentiment (score: 0.10). XAUUSD spot at $4742.41. Technical levels: support $4695, resistance $4790.",
    "provenance": "cornerstones_gold_context",
    "degraded": false,
    "timestamp": "2026-05-07T13:21:50.219441Z"
  },
  "provenance": "cornerstones_gold_context",
  "degraded": false,
  "message": "Cornerstones gold context"
}

Access

Context packets require Pro or Max context access. If unavailable, use the allowed underlying market truth commands and clearly state what is missing.