macroeconomic

Get Economic Calendar Events

Get economic calendar events with flexible filtering

Credits: configurable (see MACRO_* env vars); cache hits are free

Data Source: ForexFactory and other financial calendars Date Range: 2007-01-01 to 2026-02-27 Total Events: 200,000+

Filters:

  • currency: Filter by currency code (USD, EUR, GBP, JPY, AUD, CAD, NZD, CNY, CHF, etc.)
  • impact: Filter by impact level (Low, Medium, High, Holiday)
  • event_name: Search in event names (case-insensitive partial match)
  • start_date: Filter events from this date/time onwards
  • end_date: Filter events up to this date/time
  • source: Filter by data source (forexfactory, etc.)
  • limit: Maximum records (1-1000, default 100)
  • offset: Skip records for pagination

Returns:

  • List of economic calendar events with full details
  • Total count of matching records
  • Applied filters summary

Event Fields:

  • event_datetime: When the event occurs
  • currency: Currency affected by the event
  • impact: Impact level on the market
  • event_name: Name of the economic indicator/event
  • actual: Actual value released
  • forecast: Forecasted value
  • previous: Previous value
  • detail_url: Link to more details
get/macro/economic-calendar

Request

  • Base URL: https://api.fincept.in (the document declares no server; this is the origin it was published from)
  • URL: https://api.fincept.in/macro/economic-calendar
  • Auth: API key in header X-API-Key

Query parameters

currencystring nullable

Filter by currency code (e.g., USD, EUR, GBP)

impactstring nullable

Filter by impact level (Low, Medium, High, Holiday)

event_namestring nullable

Search event name (partial match)

start_datestring nullable

Start datetime (YYYY-MM-DD or YYYY-MM-DD HH:MM:SS)

end_datestring nullable

End datetime (YYYY-MM-DD or YYYY-MM-DD HH:MM:SS)

sourcestring nullable

Filter by data source (e.g., forexfactory)

limitinteger

Maximum number of records to return

offsetinteger

Number of records to skip

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.