Finance

Market calendar (earnings, dividends, splits, economic events)

Changed on Oct 10, 2026

get/api/v2/market/calendar

Request

Base URL: https://sugra.ai
URL: https://sugra.ai/api/v2/market/calendar
Auth: API key in header x-api-key

Query parameters

start_datestring nullable

YYYY-MM-DD (default: today). Max 31-day range.

end_datestring nullable

YYYY-MM-DD (default: today + 7 days). Max 31-day range.

sectionsstring nullable

Optional comma-separated sections to return: earnings, dividends, splits, economic_events. Omit for all four.

countrystring nullable

Optional comma-separated country names that economic_events rows must match (case-insensitive, e.g. United States). Other sections are not filtered by it.

limitinteger nullable

Optional maximum rows per returned section. Omit for every row.

offsetinteger nullable

Optional number of rows to skip in each returned section (zero-indexed).

Response

Composite market calendar: earnings, dividends, splits and macro economic events for the date range.

Example response

{
  "meta": {
    "endpoint": "/api/v1/fred/us/cpi",
    "data_time": "2026-04-16T14:30:00Z",
    "response_time": "2026-04-16T14:30:12Z",
    "provider": "Sugra API v1.0.1",
    "data_age_days": 8.532,
    "source": "sugra_crypto",
    "attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
    "fallback_chain": [
      "sugra_crypto",
      "sugra_finance"
    ],
    "stale_since": "2026-09-08T12:00:00Z",
    "period": "2026-Q1",
    "notes": "the UKMTO report behind these counts is dated 2026-08-21 and is 11 days old"
  }
}

Changes

Oct 10, 20264cb5820eb4f9 Revision changes
- breaking
  the response property / became optional for the status
- breaking
  the response property / became optional for the status
- breaking
  the response property / became optional for the status
- breaking
  the response property / became optional for the status
- breaking
  the / response's property type changed from object to no type for status
- breaking
  the / response's property type changed from object to no type for status
- breaking
  the / response's property type changed from object to no type for status
- breaking
  the / response's property type changed from object to no type for status
- breaking
  removed the required property // from the response with the status
- breaking
  removed the required property // from the response with the status
- breaking
  removed the required property // from the response with the status
- breaking
  removed the required property // from the response with the status
- breaking
  removed the required property // from the response with the status
- breaking
  removed the required property // from the response with the status
- breaking
  removed the required property // from the response with the status
- breaking
  removed the required property // from the response with the status
- info
  added the new optional query request parameter country
- info
  added the new optional query request parameter limit
- info
  added the new optional query request parameter offset
- info
  added the new optional query request parameter sections
- info
  added subschema #2 to the / response property anyOf list for the response status
- info
  added subschema #2 to the / response property anyOf list for the response status
- info
  added subschema #2 to the / response property anyOf list for the response status
- info
  added subschema #2 to the / response property anyOf list for the response status
Sep 13, 2026d2472ec2cf81 Revision changes
- breaking
  added subschema #2 to the response body oneOf list for the response status
- breaking
  the response's body type changed from object to no type for status
- breaking
  removed the required property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status

Operation history (6 revisions)