Finance

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

get/api/v2/market/calendar

Query parameters

start_datestring nullable

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

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

end_datestring nullable

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

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

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",
    "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"
    ]
  }
}

Changes

Changed in 2 of the 21 revisions of this API.116

    • added the optional property code to the response with the 401 status

      response-optional-property-added

    • added the optional property code to the response with the 429 status

      response-optional-property-added

    • added the optional property code to the response with the 503 status

      response-optional-property-added

    • added the optional property hint to the response with the 401 status

      response-optional-property-added

    • added the optional property hint to the response with the 429 status

      response-optional-property-added

    • added the optional property hint to the response with the 503 status

      response-optional-property-added

    • added the optional property plan to the response with the 401 status

      response-optional-property-added

    • added the optional property plan to the response with the 429 status

      response-optional-property-added

    • added the optional property plan to the response with the 503 status

      response-optional-property-added

    • added the optional property reason to the response with the 401 status

      response-optional-property-added

    • added the optional property reason to the response with the 429 status

      response-optional-property-added

    • added the optional property reason to the response with the 503 status

      response-optional-property-added

  • 7fc920a3005c14See the full diff
    • removed the required property data/data from the response with the 200 status

      response-required-property-removed

    • added the required property data/dividends to the response with the 200 status

      response-required-property-added

    • added the required property data/earnings to the response with the 200 status

      response-required-property-added

    • added the required property data/economic_events to the response with the 200 status

      response-required-property-added

    • added the required property data/splits to the response with the 200 status

      response-required-property-added

    This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog