{"openapi":"3.1.0","info":{"title":"Trading Economics (BYOK) API","version":"0.1.0","description":"Trading Economics (BYOK) lets an AI assistant read your own Trading Economics data through the Trading Economics API with a key you supply (Trading Economics API key). Read-only: 9 tools (get_country_indicators, get_indicator_all_countries, get_indicator_history, get_calendar_by_dates, get_calendar_by_importance, get_market_snapshot, get_market_history, get_forecast_by_country_indicator,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-tradingeconomics.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-tradingeconomics/docs"},"termsOfService":"https://connectorbay.com/byok-tradingeconomics/terms"},"servers":[{"url":"https://byok-tradingeconomics.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-tradingeconomics/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/get_country_indicators":{"post":{"operationId":"get_country_indicators","summary":"Get the latest value of every economic indicator of a country (GDP, inflation, rates, trade and more) with previous valu","description":"Get the latest value of every economic indicator of a country (GDP, inflation, rates, trade and more) with previous value, unit, frequency and source. Plans limit rows and speed (about 2 requests a second, 260-character URLs). Use for \"What are the latest economic indicators for Mexico\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"country":{"description":"Country name in lower case, for example mexico, united states or sweden.","maxLength":60,"title":"Country","type":"string"},"group":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only one indicator category group (for example Trade), as named in the CategoryGroup field of the answer.","title":"Group"}},"required":["country"],"title":"get_country_indicatorsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_indicator_all_countries":{"post":{"operationId":"get_indicator_all_countries","summary":"Get the latest value of one indicator for all countries that have it, for example inflation rate worldwide. Plans limit ","description":"Get the latest value of one indicator for all countries that have it, for example inflation rate worldwide. Plans limit rows and speed (about 2 requests a second, 260-character URLs). Use for \"Which countries have the highest inflation rate right now\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"indicator":{"description":"Indicator name, for example gdp, inflation rate or unemployment rate.","maxLength":100,"title":"Indicator","type":"string"}},"required":["indicator"],"title":"get_indicator_all_countriesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_indicator_history":{"post":{"operationId":"get_indicator_history","summary":"Get the historical series of one indicator for one country: date, value and frequency. Plans limit rows and speed (about","description":"Get the historical series of one indicator for one country: date, value and frequency. Plans limit rows and speed (about 2 requests a second, 260-character URLs). Use for \"Show Mexico's GDP history\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"country":{"description":"Country name in lower case, for example mexico, united states or sweden.","maxLength":60,"title":"Country","type":"string"},"indicator":{"description":"Indicator name, for example gdp, inflation rate or unemployment rate.","maxLength":100,"title":"Indicator","type":"string"}},"required":["country","indicator"],"title":"get_indicator_historyArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_calendar_by_dates":{"post":{"operationId":"get_calendar_by_dates","summary":"Get the economic calendar events of a country between two dates with actual, previous and forecast values and importance","description":"Get the economic calendar events of a country between two dates with actual, previous and forecast values and importance (1 low to 3 high). Plans limit rows and speed (about 2 requests a second, 260-character URLs). Use for \"What economic releases are scheduled for the United States between 2026-10-19 and 2026-10-23\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"country":{"description":"Country name in lower case, for example mexico, united states or sweden.","maxLength":60,"title":"Country","type":"string"},"from_date":{"description":"First day, YYYY-MM-DD.","maxLength":10,"title":"From Date","type":"string"},"to_date":{"description":"Last day, YYYY-MM-DD.","maxLength":10,"title":"To Date","type":"string"}},"required":["country","from_date","to_date"],"title":"get_calendar_by_datesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_calendar_by_importance":{"post":{"operationId":"get_calendar_by_importance","summary":"Get the upcoming economic calendar events of a country filtered by importance (1 low, 2 medium, 3 high). Plans limit row","description":"Get the upcoming economic calendar events of a country filtered by importance (1 low, 2 medium, 3 high). Plans limit rows and speed (about 2 requests a second, 260-character URLs). Use for \"What high importance economic events are coming for Germany\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"country":{"description":"Country name in lower case, for example mexico, united states or sweden.","maxLength":60,"title":"Country","type":"string"},"importance":{"description":"Importance level: 1, 2 or 3.","maximum":3,"minimum":1,"title":"Importance","type":"integer"}},"required":["country","importance"],"title":"get_calendar_by_importanceArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_market_snapshot":{"post":{"operationId":"get_market_snapshot","summary":"Get the latest quotes of a market category: price, state, daily, weekly, monthly and yearly change. Plans limit rows and","description":"Get the latest quotes of a market category: price, state, daily, weekly, monthly and yearly change. Plans limit rows and speed (about 2 requests a second, 260-character URLs). Use for \"What are the latest commodity prices\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"category":{"description":"Market category: commodities, currency, index, bond or crypto.","enum":["commodities","currency","index","bond","crypto"],"title":"Category","type":"string"},"country":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Only quotes of this country, for example france (shown in the provider's bond example).","title":"Country"}},"required":["category"],"title":"get_market_snapshotArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_market_history":{"post":{"operationId":"get_market_history","summary":"Get the daily open, high, low and close of a market symbol (stock, index, currency, commodity) between two dates. Plans ","description":"Get the daily open, high, low and close of a market symbol (stock, index, currency, commodity) between two dates. Plans limit rows and speed (about 2 requests a second, 260-character URLs). Use for \"Show the price history of AAPL:US in October 2026\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"symbol":{"description":"Trading Economics symbol, for example AAPL:US, EURUSD:CUR or CL1:COM.","maxLength":40,"title":"Symbol","type":"string"},"start_date":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"First day, YYYY-MM-DD.","title":"Start Date"},"end_date":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Last day, YYYY-MM-DD.","title":"End Date"}},"required":["symbol"],"title":"get_market_historyArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_forecast_by_country_indicator":{"post":{"operationId":"get_forecast_by_country_indicator","summary":"Get Trading Economics forecasts (next four quarters and year ends) of one indicator for one country. Plans limit rows an","description":"Get Trading Economics forecasts (next four quarters and year ends) of one indicator for one country. Plans limit rows and speed (about 2 requests a second, 260-character URLs). Use for \"What is the forecast for Mexico's GDP\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"country":{"description":"Country name in lower case, for example mexico, united states or sweden.","maxLength":60,"title":"Country","type":"string"},"indicator":{"description":"Indicator name, for example gdp, inflation rate or unemployment rate.","maxLength":100,"title":"Indicator","type":"string"}},"required":["country","indicator"],"title":"get_forecast_by_country_indicatorArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_latest_news":{"post":{"operationId":"get_latest_news","summary":"Get the latest Trading Economics news items on economic releases with country, category, date and description. Plans lim","description":"Get the latest Trading Economics news items on economic releases with country, category, date and description. Plans limit rows and speed (about 2 requests a second, 260-character URLs). Use for \"What is the latest economic news\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many news items to return.","title":"Limit"},"start":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Index of the first item (for paging).","title":"Start"}},"title":"get_latest_newsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}