{ "description": "Choose a data surface: live markets, country indicators, global rankings, economic calendar, forecasts, public holidays, earnings, historical series, news, search, credit ratings or bond yields.", "properties": { "category": { "default": "", "description": "Restrict the market table to one category or region. Commodities use Energy/Metals/Agricultural/Industrial/Livestock/Index/Electricity; currencies, stocks and bonds use Major/Europe/America/Asia/Oceania/Africa; crypto uses Crypto/BTC/ETH; shares use Top Gainers/Top Losers. Leave unset for all rows.", "editor": "select", "enum": [ "", "Energy", "Metals", "Agricultural", "Industrial", "Livestock", "Index", "Electricity", "Major", "Europe", "America", "Asia", "Oceania", "Africa", "Crypto", "BTC", "ETH", "Top Gainers", "Top Losers" ], "enumTitles": [ "All categories/regions", "Energy (commodities)", "Metals (commodities)", "Agricultural (commodities)", "Industrial (commodities)", "Livestock (commodities)", "Index (commodities)", "Electricity (commodities)", "Major (currencies/stocks/bonds)", "Europe (currencies/stocks/bonds)", "America (currencies/stocks/bonds)", "Asia (currencies/stocks/bonds)", "Oceania (currencies/stocks/bonds)", "Africa (currencies/stocks/bonds)", "Crypto — USD pairs", "BTC pairs", "ETH pairs", "Top Gainers (shares)", "Top Losers (shares)" ], "prefill": "", "title": "Category / region (mode=markets)", "type": "string" }, "countries": { "default": [], "description": "One or more countries. Required for countryIndicators, countryForecast, creditRatingHistory and bondYields. Optional for calendar, holidays and earningsCalendar (leave empty for global data).", "editor": "select", "items": { "enum": [ "afghanistan", "albania", "algeria", "andorra", "angola", "antigua-and-barbuda", "argentina", "armenia", "aruba", "australia", "austria", "azerbaijan", "bahamas", "bahrain", "bangladesh", "barbados", "belarus", "belgium", "belize", "benin", "bermuda", "bhutan", "bolivia", "bosnia-and-herzegovina", "botswana", "brazil", "brunei", "bulgaria", "burkina-faso", "burundi", "cambodia", "cameroon", "canada", "cape-verde", "cayman-islands", "central-african-republic", "chad", "chile", "china", "colombia", "comoros", "congo", "costa-rica", "croatia", "cuba", "cyprus", "czech-republic", "denmark", "djibouti", "dominica", "dominican-republic", "east-timor", "ecuador", "egypt", "el-salvador", "equatorial-guinea", "eritrea", "estonia", "ethiopia", "euro-area", "faroe-islands", "fiji", "finland", "france", "gabon", "gambia", "georgia", "germany", "ghana", "greece", "grenada", "guatemala", "guinea", "guinea-bissau", "guyana", "haiti", "honduras", "hong-kong", "hungary", "iceland", "india", "indonesia", "iran", "iraq", "ireland", "isle-of-man", "israel", "italy", "ivory-coast", "jamaica", "japan", "jordan", "kazakhstan", "kenya", "kiribati", "kosovo", "kuwait", "kyrgyzstan", "laos", "latvia", "lebanon", "lesotho", "liberia", "libya", "liechtenstein", "lithuania", "luxembourg", "macau", "macedonia", "madagascar", "malawi", "malaysia", "maldives", "mali", "malta", "mauritania", "mauritius", "mexico", "moldova", "monaco", "mongolia", "montenegro", "morocco", "mozambique", "myanmar", "namibia", "nepal", "netherlands", "new-caledonia", "new-zealand", "nicaragua", "niger", "nigeria", "north-korea", "norway", "oman", "pakistan", "palestine", "panama", "papua-new-guinea", "paraguay", "peru", "philippines", "poland", "portugal", "puerto-rico", "qatar", "republic-of-the-congo", "romania", "russia", "rwanda", "samoa", "sao-tome-and-principe", "saudi-arabia", "senegal", "serbia", "seychelles", "sierra-leone", "singapore", "slovakia", "slovenia", "solomon-islands", "somalia", "south-africa", "south-korea", "south-sudan", "spain", "sri-lanka", "sudan", "suriname", "swaziland", "sweden", "switzerland", "syria", "taiwan", "tajikistan", "tanzania", "thailand", "togo", "tonga", "trinidad-and-tobago", "tunisia", "turkey", "turkmenistan", "uganda", "ukraine", "united-arab-emirates", "united-kingdom", "united-states", "uruguay", "uzbekistan", "vanuatu", "venezuela", "vietnam", "yemen", "zambia", "zimbabwe" ], "type": "string" }, "prefill": [], "title": "Countries (multi-select)", "type": "array" }, "dateFrom": { "default": "", "description": "ISO date (YYYY-MM-DD). Lower bound for calendar, holidays, earnings, credit-rating history, bond yields and history points. For calendar this fetches the requested range, not just the default page.", "editor": "textfield", "prefill": "", "title": "Date from", "type": "string" }, "dateTo": { "default": "", "description": "ISO date (YYYY-MM-DD). Upper bound for the same date-aware modes.", "editor": "textfield", "prefill": "", "title": "Date to", "type": "string" }, "forecastAssetClass": { "default": "commodity", "description": "Which public forecast table to collect.", "editor": "select", "enum": [ "commodity", "currency", "crypto", "stockMarket", "governmentBond10Y" ], "enumTitles": [ "Commodities", "Currencies", "Cryptocurrencies", "Stock market indices", "Government bonds (10Y)" ], "prefill": "commodity", "title": "Forecast asset class (mode=marketForecast)", "type": "string" }, "historySpan": { "default": "5y", "description": "How far back to fetch historical series. `max` returns the full available history.", "editor": "select", "enum": [ "1m", "3m", "6m", "1y", "2y", "5y", "10y", "max" ], "enumTitles": [ "1 month", "3 months", "6 months", "1 year", "2 years", "5 years", "10 years", "Maximum available" ], "prefill": "1y", "title": "History span (history modes)", "type": "string" }, "importance": { "default": "", "description": "Keep only releases/news at this market-impact level. Leave unset for all levels.", "editor": "select", "enum": [ "", "low", "medium", "high" ], "enumTitles": [ "All levels", "Low", "Medium", "High" ], "prefill": "", "title": "Importance (calendar, earnings, news)", "type": "string" }, "indicatorCategory": { "default": "", "description": "Restrict country indicators or forecasts to one category. `markets` only appears on the forecast page and `health` only on the indicators page. Leave unset for all categories.", "editor": "select", "enum": [ "", "overview", "gdp", "labour", "prices", "money", "trade", "government", "business", "consumer", "housing", "energy", "health", "markets" ], "enumTitles": [ "All categories", "Overview", "GDP", "Labour", "Prices", "Money", "Trade", "Government", "Business", "Consumer", "Housing", "Energy", "Health (country indicators)", "Markets (country forecast)" ], "prefill": "", "title": "Indicator category (mode=countryIndicators, countryForecast)", "type": "string" }, "indicatorHistoryUrls": { "default": [], "description": "Trading Economics indicator pages as full URLs or `country/indicator-slug`, e.g. `united-states/inflation-cpi` or `https://tradingeconomics.com/germany/unemployment-rate`. Up to 100 pages.", "editor": "stringList", "items": { "type": "string" }, "prefill": [], "title": "Indicator pages (mode=indicatorHistory)", "type": "array" }, "marketInterval": { "default": "auto", "description": "Intraday or daily interval for market history. Leave on `auto` to use the span's natural frequency.", "editor": "select", "enum": [ "auto", "1m", "5m", "15m", "30m", "1h", "1d", "1w", "1M" ], "enumTitles": [ "Automatic", "1 minute", "5 minutes", "15 minutes", "30 minutes", "1 hour", "1 day", "1 week", "1 month" ], "prefill": "auto", "title": "Market interval (mode=marketHistory)", "type": "string" }, "marketSymbols": { "default": [], "description": "Symbols such as `CL1:COM`, `AAPL:US`, `USGG10YR:IND` or full Trading Economics market URLs. Up to 100 symbols.", "editor": "stringList", "items": { "type": "string" }, "prefill": [], "title": "Market symbols or pages (mode=marketHistory)", "type": "array" }, "marketType": { "default": "commodities", "description": "Which live market table to collect.", "editor": "select", "enum": [ "commodities", "currencies", "stocks", "bonds", "crypto", "shares" ], "enumTitles": [ "Commodities (energy, metals, agricultural...)", "Currencies (FX pairs)", "Stock market indices", "Government bond yields (10Y)", "Cryptocurrencies", "Shares (top gaining/losing stocks)" ], "prefill": "commodities", "title": "Market type (mode=markets)", "type": "string" }, "maxChangePercent": { "description": "Only keep instruments whose daily percent change is at most this value.", "maximum": 1000, "minimum": -1000, "title": "Max daily % change (mode=markets)", "type": "number" }, "maxItems": { "default": 100, "description": "Hard cap on emitted records. History modes cap the total number of points across all requested series.", "maximum": 10000, "minimum": 1, "prefill": 3, "title": "Max items", "type": "integer" }, "minChangePercent": { "description": "Only keep instruments whose daily percent change is at least this value. Enter -5 for -5%.", "maximum": 1000, "minimum": -1000, "title": "Min daily % change (mode=markets)", "type": "number" }, "mode": { "default": "markets", "description": "Which Trading Economics surface to collect.", "editor": "select", "enum": [ "markets", "countryIndicators", "indicatorRanking", "calendar", "countryForecast", "holidays", "earningsCalendar", "indicatorHistory", "marketHistory", "marketForecast", "news", "search", "creditRatingHistory", "bondYields" ], "enumTitles": [ "Markets (commodities / currencies / stocks / bonds / crypto / shares)", "Country indicators (GDP, inflation, unemployment...)", "Global indicator ranking (one or more indicators, all countries)", "Economic calendar (global or per-country)", "Country forecast (quarter-ahead projections)", "Public holidays (global or per-country)", "Earnings calendar (per-country or global)", "Indicator history (historical time series)", "Market history (historical prices, intraday to max)", "Market forecast (commodities / currencies / indices / bonds / crypto)", "Economic news (latest stream)", "Search indicators and markets", "Credit-rating history (S&P / DBRS / TE)", "Government bond yields (all maturities)" ], "prefill": "markets", "title": "Mode", "type": "string" }, "rankingIndicators": { "default": [ "interest-rate" ], "description": "One or more indicators to rank across every country. The `rating` indicator returns sovereign credit ratings instead of a numeric series.", "editor": "select", "items": { "enum": [ "interest-rate", "inflation-rate", "unemployment-rate", "gdp-growth-rate", "gdp-per-capita", "current-account-to-gdp", "gold-reserves", "government-debt-to-gdp", "crude-oil-production", "gasoline-prices", "rating", "asylum-applications", "average-annual-wages", "balance-of-trade", "bank-lending-rate", "bankruptcies", "banks-balance-sheet", "building-permits", "business-confidence", "capacity-utilization", "capital-flows", "car-production", "car-registrations", "cash-reserve-ratio", "cement-production", "central-bank-balance-sheet", "changes-in-inventories", "co2-emissions", "construction-output", "consumer-confidence", "consumer-credit", "consumer-price-index-cpi", "consumer-spending", "core-consumer-prices", "core-inflation-rate", "corporate-profits", "corporate-tax-rate", "corruption-index", "corruption-rank", "cpi-housing-utilities", "crude-oil-rigs", "current-account", "deposit-interest-rate", "disposable-personal-income", "electric-car-registrations", "electricity-production", "employed-persons", "employment-change", "employment-change-yoy", "employment-rate", "export-prices", "exports", "external-debt", "factory-orders", "fiscal-expenditure", "food-inflation", "foreign-direct-investment", "foreign-exchange-reserves", "full-time-employment", "full-year-gdp-growth", "gdp", "gdp-annual-growth-rate", "gdp-constant-prices", "gdp-deflator", "gdp-from-agriculture", "gdp-from-construction", "gdp-from-manufacturing", "gdp-from-mining", "gdp-from-public-administration", "gdp-from-services", "gdp-from-transport", "gdp-from-utilities", "gdp-per-capita-ppp", "government-budget", "government-budget-value", "government-debt", "government-revenues", "government-spending", "government-spending-to-gdp", "gross-average-monthly-wages", "gross-fixed-capital-formation", "gross-national-product", "harmonised-consumer-prices", "harmonised-inflation-rate-mom", "harmonised-inflation-rate-yoy", "home-ownership-rate", "hospital-beds", "hospitals", "households-debt-to-gdp", "households-debt-to-income", "housing-index", "housing-starts", "icu-beds", "import-prices", "imports", "industrial-production", "industrial-production-mom", "inflation-expectations", "inflation-rate-mom", "initial-jobless-claims", "interbank-rate", "job-vacancies", "labor-force-participation-rate", "labour-costs", "leading-economic-index", "lending-rate", "loan-growth", "loans-to-private-sector", "long-term-unemployment-rate", "manufacturing-production", "medical-doctors", "military-expenditure", "minimum-wages", "mining-production", "money-supply-m0", "money-supply-m1", "money-supply-m2", "money-supply-m3", "natural-gas-stocks-capacity", "natural-gas-stocks-injection", "natural-gas-stocks-inventory", "natural-gas-stocks-withdrawal", "new-orders", "non-farm-payrolls", "nurses", "part-time-employment", "personal-income-tax-rate", "personal-savings", "personal-spending", "population", "precipitation", "price-to-rent-ratio", "private-debt-to-gdp", "private-sector-credit", "producer-price-inflation-mom", "producer-prices", "producer-prices-change", "productivity", "remittances", "residential-property-prices", "retail-sales-mom", "retail-sales-yoy", "retirement-age-men", "retirement-age-women", "sales-tax-rate", "small-business-sentiment", "social-security-rate", "social-security-rate-for-companies", "social-security-rate-for-employees", "steel-production", "temperature", "terms-of-trade", "terrorism-index", "total-vehicle-sales", "tourism-revenues", "tourist-arrivals", "unemployed-persons", "wage-growth", "wages", "wages-in-manufacturing", "weapons-sales", "youth-unemployment-rate", "zew-economic-sentiment-index" ], "type": "string" }, "prefill": [ "interest-rate" ], "title": "Ranking indicators (mode=indicatorRanking)", "type": "array" }, "searchKeyword": { "default": "", "description": "Case-insensitive substring filter on the record name/title (instrument, indicator, event, company or news headline). Leave blank for no filtering.", "editor": "textfield", "prefill": "", "title": "Keyword filter", "type": "string" }, "searchQuery": { "default": "", "description": "Keyword used to resolve indicators and markets, e.g. `gold`, `inflation`, `EURUSD`. Required for mode=search.", "editor": "textfield", "prefill": "gold", "title": "Search query (mode=search)", "type": "string" } }, "required": [ "mode" ], "schemaVersion": 1, "title": "Trading Economics Scraper Input", "type": "object" }