---
title: "Get macro insights of the global economy or a specific region based on the provided filters. Describes what's happening in the economy and how it affects the markets."
method: GET
path: "/macro_insights"
---

# Get macro insights of the global economy or a specific region based on the provided filters. Describes what's happening in the economy and how it affects the markets.

`GET /macro_insights`

## Request

- Base URL: `https://portfoliopilot.com/api/gpt`
- URL: `https://portfoliopilot.com/api/gpt/macro_insights`
- Auth: none declared
- TypeScript: <https://skmtc.dev/portfoliopilot/apis/portfoliopilot-plugin/docs/macro_insights/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `region` 'US' | 'Canada' | 'World'

## Response `200`

OK

- MacroInsightsResponse
  - `top_macro_insights` MacroInsight[]: A list of macro insights for the given region or the entire world
    - `title` string: The title is like a headline that gives a quick idea of what the economic insight is all about. It summarizes the main topic, so you know what to expect when you read further.
    - `sub_title` string: The subtitle is like a supporting headline that gives a bit more information about the economic insight
    - `chart_markdown` string: Markdown for displaying an economic macro insight providing a visual representation of the insight's data or analysis
    - `tags` string[]

## Other responses

- `400`: Bad Request
- `405`: Method not allowed (e.g. GET request type is not supported, use POST method instead)

---

[API](https://skmtc.dev/portfoliopilot/apis/portfoliopilot-plugin.md) - [All operations](https://skmtc.dev/portfoliopilot/apis/portfoliopilot-plugin/llms.txt) - [OpenAPI document](https://skmtc.dev/portfoliopilot/apis/portfoliopilot-plugin/revisions/7ed0083c9099?raw)