Reading Responses

At a glance

Cornerstones responses are designed to be easy to verify before a customer or agent uses them. Start with the market value, then check where it came from, when it was produced, and whether the current account can use the requested surface.

What to check

• Source label: the Cornerstones source family attached to the quote, chart, event, or context packet.
• Timestamp or freshness: the as-of time for prices, events, artifacts, and generated context.
• Data quality: whether the response is complete, partial, stale, estimated, or unavailable.
• Access: whether the current account can use the requested market surface.
• Symbol handling: requested and resolved symbols when normalization matters, especially A-shares.

Recommended pattern

1. Run the command for a bounded market question.
2. Read the top-level source label and timestamp.
3. Check any quality or availability notes before summarizing.
4. If a surface is unavailable, choose the closest allowed command instead of guessing.

Live auth response

Captured from a live Cornerstones API response on 2026-05-07T13:21Z. The capture key is not shown.

{
  "status": "ok",
  "service": "cornerstones",
  "version": "0.4.2",
  "authenticated_user": "ops-admin-20260428-025215@usecornerstones.local",
  "key_id": "docs-live-max-20260507132113"
}

Live market-truth response

Captured from a live Cornerstones API response on 2026-05-07T13:21Z. Source details are normalized to Cornerstones labels.

{
  "symbol": "XAUUSD",
  "timeframe": "1h",
  "bars": [
    {
      "symbol": "XAUUSD",
      "timeframe": "1h",
      "open": 4735.71,
      "high": 4743.52,
      "low": 4727.03,
      "close": 4742.6,
      "volume": 9048,
      "timestamp": "2026-05-07T15:00:00+01:00",
      "provenance": "cornerstones_market_data",
      "degraded": false
    }
  ],
  "count": 1,
  "provenance": "cornerstones_market_data",
  "degraded": false,
  "message": "Cornerstones realtime candlesticks"
}

Copy rule for agent prompts

When you ask an agent to use Cornerstones, include this instruction:

Before using Cornerstones market data, check source labels, freshness, data quality, access, and timestamps. If a requested surface is unavailable, use an allowed command instead of guessing.