---
title: "Get Te Economic Calendar"
method: GET
path: "/macro/upcoming-events"
tags: ["macroeconomic"]
---

# Get Te Economic Calendar

`GET /macro/upcoming-events`

## 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/upcoming-events`
- Auth: API key in header `X-API-Key`

Query Trading Economics economic calendar events

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

**Data:** Near-term economic events scraped from Trading Economics
**Date Range:** Current week and upcoming days

**Filters:**
- country: ISO country code (US, DE, JP, GB, FR, CA, AU, IN, etc.)
- category: Event category (partial match)
- event: Event name search (partial match)
- start_date / end_date: Date range (YYYY-MM-DD)
- importance: Importance level (integer)
- limit / offset: Pagination

**Returns:** Economic events with actual, forecast, previous values

## Query parameters

- `country` string, nullable: Filter by country code (e.g. US, DE, JP, GB, FR, IN)
- `category` string, nullable: Filter by category (partial match)
- `event` string, nullable: Search by event name (partial match)
- `start_date` string, nullable: Start date (YYYY-MM-DD)
- `end_date` string, nullable: End date (YYYY-MM-DD)
- `importance` integer, nullable: Filter by importance level
- `limit` integer: Max records to return
- `offset` integer: Records to skip

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/fincept/apis/fincept-api.md) · [All operations](https://skmtc.dev/fincept/apis/fincept-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fincept/apis/fincept-api/revisions/e9c0076ea55a?raw)