Documentation

Events & Evidence

Recent events, receipts, filings, earnings, and catalyst evidence for agents.

Copy this to your agent Help first
python -m pip install cornerstones-client
cornerstones-client --help
cornerstones-client guide
Events & Evidence Customer guide

At a glance

Events are the citations behind an agent's market note. Cornerstones should make catalysts, receipts, filings, earnings schedules, corporate actions, and evidence references easy to request and easy to quote.

Commands

CommandCopyable
cornerstones-client events recent
cornerstones-client events history --symbol AAPL
cornerstones-client events receipts
cornerstones-client events subscribe --symbol AAPL
cornerstones-client events delete --id evt_example_001
cornerstones-client stocks earnings --symbol AAPL
cornerstones-client stocks filings --symbol AAPL
cornerstones-client stocks corporate-actions --symbol AAPL

What to ask

  • What changed recently?
  • Which event is scheduled next?
  • What evidence id or receipt can I cite?
  • Is this official corporate evidence, scheduled macro context, or source-aware public evidence?
  • Is the feed fresh enough for the workflow?

Live responses

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.

events recent

JSON responseCopyable
{
  "events": [],
  "count": 0,
  "next_cursor": null,
  "has_more": false,
  "provenance": "cornerstones_events_v1",
  "data_quality": {
    "provider_status": "primary",
    "store": "file_backed_json",
    "scope": "recent_or_active_events",
    "lookback_hours": 24
  },
  "degraded": false,
  "fallback": null
}

events history --symbol AAPL

JSON responseCopyable
{
  "events": [],
  "count": 0,
  "next_cursor": null,
  "has_more": false,
  "provenance": "cornerstones_events_v1",
  "data_quality": {
    "provider_status": "primary",
    "store": "file_backed_json",
    "scope": "all_persisted_events"
  },
  "degraded": false,
  "fallback": null
}

events receipts

JSON responseCopyable
{
  "receipts": [],
  "count": 0,
  "provenance": "cornerstones_events_v1",
  "data_quality": {
    "provider_status": "primary",
    "store": "file_backed_json",
    "scope": "event_consumer_receipts",
    "transport_semantics": "independent"
  },
  "degraded": false,
  "fallback": null
}

Access

Recent event reads may be available with Free keys where enabled. Event export and deeper evidence workflows require Pro or higher access.