GET /v1/market/calendar - SEC API for AI

curl -X GET -H "x-api-key: $SECAPI_API_KEY" -H "secapi-version: 2026-03-19" "https://api.secapi.ai/v1/market/calendar?market=XNYS&start=2026-07-01&duration=5"

{
  "object": "list",
  "data": [
    {
      "object": "market_calendar_day",
      "id": "mkt_xnys_20260703",
      "createdAt": "2026-07-01T00:00:00.000Z",
      "livemode": false,
      "market": "XNYS",
      "marketName": "New York Stock Exchange",
      "date": "2026-07-03",
      "timezone": "America/New_York",
      "sessionStatus": "closed",
      "opensAt": null,
      "closesAt": null,
      "holidayName": "Independence Day (observed)",
      "coverage": "configured_holidays",
      "confidence": "confirmed",
      "statusNote": "Closed for Independence Day (observed).",
      "provenance": {
        "source": "exchange",
        "accessionNumber": null,
        "filingUrl": "https://www.nyse.com/markets/hours-calendars",
        "retrievedAt": "2026-07-01T00:00:00.000Z",
        "parserVersion": "example"
      }
    }
  ],
  "hasMore": false,
  "nextCursor": null,
  "supportedMarkets": [
    {
      "code": "XNYS",
      "name": "New York Stock Exchange",
      "region": "North America",
      "countryCode": "US",
      "timezone": "America/New_York",
      "coverage": "configured_holidays",
      "sourceUrl": "https://www.nyse.com/markets/hours-calendars",
      "rightsStatus": "public_source_documented",
      "syncCadence": "daily_midnight_local",
      "lastReviewedAt": "2026-03-17"
    }
  ],
  "requestId": "req_2ZK8Q1W9F4M6P7R3"
}

Check scheduled trading sessions for a supported market

Audience: developers and agents scheduling market-aware jobs.

Coverage and source scope

Use this route before scheduling a market-data job or interpreting a missing daily observation. It returns a bounded calendar window for one supported market and identifies whether each row uses configured-holiday or weekend-only coverage. sessionStatus is a schedule, not evidence that trading occurred or that an exchange did not change its hours. Preserve coverage, confidence, statusNote, and row-level provenance when a workflow depends on the result. See API conventions.

Canonical metadata

data
supportedMarkets
coverage
confidence
statusNote
per-row provenance
requestId

Example request

curl -X GET -H "x-api-key: $SECAPI_API_KEY" -H "secapi-version: 2026-03-19" "https://api.secapi.ai/v1/market/calendar?market=XNYS&start=2026-07-01&duration=5"

Example response

{
  "object": "list",
  "data": [
    {
      "object": "market_calendar_day",
      "id": "mkt_xnys_20260703",
      "createdAt": "2026-07-01T00:00:00.000Z",
      "livemode": false,
      "market": "XNYS",
      "marketName": "New York Stock Exchange",
      "date": "2026-07-03",
      "timezone": "America/New_York",
      "sessionStatus": "closed",
      "opensAt": null,
      "closesAt": null,
      "holidayName": "Independence Day (observed)",
      "coverage": "configured_holidays",
      "confidence": "confirmed",
      "statusNote": "Closed for Independence Day (observed).",
      "provenance": {
        "source": "exchange",
        "accessionNumber": null,
        "filingUrl": "https://www.nyse.com/markets/hours-calendars",
        "retrievedAt": "2026-07-01T00:00:00.000Z",
        "parserVersion": "example"
      }
    }
  ],
  "hasMore": false,
  "nextCursor": null,
  "supportedMarkets": [
    {
      "code": "XNYS",
      "name": "New York Stock Exchange",
      "region": "North America",
      "countryCode": "US",
      "timezone": "America/New_York",
      "coverage": "configured_holidays",
      "sourceUrl": "https://www.nyse.com/markets/hours-calendars",
      "rightsStatus": "public_source_documented",
      "syncCadence": "daily_midnight_local",
      "lastReviewedAt": "2026-03-17"
    }
  ],
  "requestId": "req_2ZK8Q1W9F4M6P7R3"
}

Session coverage

Start with market, start, and duration when a job needs a known exchange calendar. The response is capped at 31 consecutive dates and is not paginated. configured_holidays means the response includes the configured local holiday calendar; weekend_only means weekday exchange-holiday closures may be absent and an open row can be tentative. supportedMarkets reports the coverage posture for each listed market. See freshness and trust.

Errors

Invalid start values return a contract-aware request error. Do not substitute an unsupported market code with an assumed exchange calendar: the route defaults unsupported codes to XNYS.

Give this prompt to your agent

Failure posture

preserve market, date, coverage, confidence, statusNote, provenance, and requestId with a scheduled job
treat weekend-only coverage as a calendar aid, not an exchange-authoritative holiday feed
do not infer a trading session from an absent date outside the requested window

GET /v1/market/bars GET /v1/market/corporate-actions

​Coverage and source scope

​Canonical metadata

​Example request

​Example response

​Session coverage

​Errors

​Give this prompt to your agent

​Failure posture

Coverage and source scope

Canonical metadata

Example request

Example response

Session coverage

Errors

Give this prompt to your agent

Failure posture