DatoQA — Economic Indicators
Official country economic indicators and annual history, with units, dates, citations and gaps.
我該用這個嗎
品質與安全性
A
根據工具定義與協定合規性的自動化分析。
上下文成本
~8,220Token（工具定義）
~6.8 KB典型回應大小
顯著的注意力影響（128k 上下文的 6.42%）
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高，可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案：
{
"mcpServers": {
"economic-indicators": {
"url": "https://datoqa.bhazarstudio.workers.dev/mcp/economy"
}
}
}遠端端點
https://datoqa.bhazarstudio.workers.dev/mcp/economystreamable-http它能做什麼
工具清單
工具（13）
🟢 唯讀🟡 寫入🔴 刪除⚪ 未知
🟢catalog(report_countries, report_indicators, report_from, report_to, language)
Inspect this connection’s scope, tools and access policy. With no arguments returns the usual catalog. On the general or economy connection, optionally supply report_countries (1–10 World Bank codes) for a FREE live preview of the optional paid country comparison: population/GDP/inflation by default, or up to six selected historical indicators over ten years, aligned JSON and CSV, definitions and source evidence. Preview reports price, missing cells, availability and the exact HTTP purchase path; it never signs or pays. Existing data tools remain free. Buying requires an authorized x402 HTTP client, not just MCP. Source/schema checks are not independent factual verification.
輸入結構描述
{
"type": "object",
"properties": {
"report_countries": {
"description": "Optional free preview for these distinct World Bank country codes, e.g. FRA, DEU, ESP. General/economy connections only.",
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Z0-9]{3}$"
}
},
"report_indicators": {
"description": "Custom historical comparison: select up to six of the 22 WDI indicators. Supply report_from and report_to together, up to ten years. Missing cells block payment.",
"minItems": 1,
"maxItems": 6,
"type": "array",
"items": {
"type": "string",
"enum": [
"population",
"gdp",
"gdp_per_capita",
"gdp_real",
"gdp_growth",
"inflation",
"life_expectancy",
"fertility",
"urban_population",
"internet_users",
"electricity_access",
"unemployment",
"renewable_energy",
"forest_area",
"agricultural_land",
"trade",
"exports",
"imports",
"infant_mortality",
"basic_drinking_water",
"basic_sanitation",
"primary_completion"
]
}
},
"report_from": {
"type": "integer",
"minimum": 1960,
"maximum": 9007199254740991
},
"report_to": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 2025
},
"language": {
"default": "en",
"type": "string",
"enum": [
"en",
"fr"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"name": {
"type": "string",
"const": "DatoQA"
},
"version": {
"type": "string"
},
"available_records": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"title": {
"type": "string"
},
"profile": {
"type": "string"
},
"tools": {
"type": "array",
"items": {
"type": "string"
}
},
"capabilities": {
"type": "array",
"items": {
"type": "string"
}
},
"independently_verified": {
"type": "boolean",
"const": false,
"description": "Official-source checks are not independent factual corroboration."
}
},
"required": [
"name"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"description": "General availability catalog or a scoped thematic directory; theme metadata is not a live availability guarantee."
}🟢list_us_economic_indicators
Discover three official BLS US monthly series, original units, seasonal adjustment, latest periods and freshness. Rolling ten calendar years, not a full archive. CPI is an index, payroll employment counts jobs in thousands. Read source notes.
輸入結構描述
{
"type": "object",
"properties": {}
}輸出結構描述
{
"type": "object",
"properties": {
"country": {
"type": "string"
},
"source": {
"type": "string"
},
"endpoint": {
"type": "string"
},
"requested_window": {
"type": "object",
"properties": {
"from": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"to": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"required": [
"from",
"to"
],
"additionalProperties": false
},
"indicators": {
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"available",
"source_unavailable_or_stale"
]
},
"period": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"latest_available": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"numeric_values": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"missing_values": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"freshness": {
"anyOf": [
{
"type": "object",
"properties": {
"observed_at": {
"type": "string"
},
"expires_at": {
"type": "string"
},
"age_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"meaning": {
"type": "string"
}
},
"required": [
"observed_at",
"expires_at",
"age_seconds",
"meaning"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"citation": {
"anyOf": [
{
"type": "object",
"properties": {
"url": {
"type": "string"
},
"publisher": {
"type": "string"
},
"retrieved_at": {
"type": "string"
}
},
"required": [
"url",
"publisher",
"retrieved_at"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"key",
"status",
"period",
"latest_available",
"numeric_values",
"missing_values",
"freshness",
"citation"
],
"additionalProperties": {}
}
},
"refresh_interval_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"max_collection_age_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"notice": {
"type": "string"
},
"independently_verified": {
"type": "boolean",
"const": false,
"description": "Official-source checks are not independent factual corroboration."
}
},
"required": [
"country",
"source",
"endpoint",
"requested_window",
"indicators",
"refresh_interval_seconds",
"max_collection_age_seconds",
"notice",
"independently_verified"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_us_economic_indicators(indicator, limit, period)
BLS US monthly consumer_price_index (CPI-U NSA, 1982-84=100), unemployment (SA percent civilian labor force 16+), nonfarm_employment (SA thousands of payroll jobs). Default last 12 monthly periods; limit 1-120 or exact period YYYY-MM, mutually exclusive. Retains source decimals, missing values, preliminary/revision footnotes and evidence. Not real-time, a percent inflation rate or monthly job creation; not independently verified.
輸入結構描述
{
"type": "object",
"properties": {
"indicator": {
"type": "string",
"enum": [
"consumer_price_index",
"unemployment",
"nonfarm_employment"
],
"description": "BLS monthly series key; use list_us_economic_indicators to check availability and units."
},
"limit": {
"description": "Latest monthly periods, default 12; omit when period is supplied.",
"type": "integer",
"minimum": 1,
"maximum": 120
},
"period": {
"description": "Exact source month YYYY-MM, for example 2025-06; cannot be combined with limit.",
"type": "string"
}
},
"required": [
"indicator"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"source_unavailable_or_stale",
"period_not_covered",
"published_monthly_data",
"no_numeric_data_in_period"
],
"description": "Read this before using values; a successful transport does not establish data availability."
},
"returned": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Domain-specific result count, not necessarily the number of stored records in items."
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"domain": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {},
"description": "Source-specific payload; inspect units, observation dates, nulls and source notes."
},
"freshness": {
"type": "object",
"properties": {
"observed_at": {
"type": "string"
},
"expires_at": {
"type": "string"
},
"age_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"meaning": {
"type": "string"
}
},
"required": [
"observed_at",
"expires_at",
"age_seconds",
"meaning"
],
"additionalProperties": false
},
"citation": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"publisher": {
"type": "string"
},
"retrieved_at": {
"type": "string"
}
},
"required": [
"url",
"publisher",
"retrieved_at"
],
"additionalProperties": false
},
"provenance": {
"type": "object",
"properties": {
"source_id": {
"type": "string"
},
"source_name": {
"type": "string"
},
"source_url": {
"type": "string"
},
"license": {
"type": "string"
},
"retrieved_at": {
"type": "string"
},
"verified_at": {
"type": "string"
},
"valid_until": {
"type": "string"
},
"verification_method": {
"type": "string"
},
"content_sha256": {
"type": "string"
},
"verification_level": {
"type": "string",
"enum": [
"official_source_and_schema_checked",
"public_aggregator_and_schema_checked",
"method_specific"
]
},
"independently_verified": {
"type": "boolean",
"const": false,
"description": "Official-source checks are not independent factual corroboration."
},
"verification_scope": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"source_id",
"source_name",
"source_url",
"license",
"retrieved_at",
"verified_at",
"valid_until",
"verification_method",
"content_sha256",
"verification_level",
"independently_verified",
"verification_scope"
],
"additionalProperties": false
},
"display_label": {
"type": "string"
}
},
"required": [
"id",
"domain",
"data",
"freshness",
"citation",
"provenance"
],
"additionalProperties": {}
}
},
"independently_verified": {
"type": "boolean",
"const": false,
"description": "Official-source checks are not independent factual corroboration."
},
"notice": {
"type": "string"
},
"directory": {
"type": "string"
},
"available_period": {
"type": "object",
"properties": {
"from": {
"type": "string"
},
"to": {
"type": "string"
}
},
"required": [
"from",
"to"
],
"additionalProperties": false
}
},
"required": [
"status",
"returned",
"items"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}🟢list_interest_rate_series(provider)
Discover scoped official policy rates: provider=boe for UK Bank Rate daily since 1975 (historical regimes and notes preserved); fed for eight US series with distinct starts since 1982 (pre-1994 target reconstructed); ecb for three current instruments and historical minimum-bid refinancing since 1999, sparse dates of changes; boc default for two Canadian daily series since 2010. Original bank data free. Inspect coverage, units, freshness and source notes. Not independently verified.
輸入結構描述
{
"type": "object",
"properties": {
"provider": {
"default": "boc",
"type": "string",
"enum": [
"boc",
"ecb",
"fed",
"boe"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"available",
"source_unavailable_or_stale"
]
},
"provider": {
"type": "string",
"enum": [
"boc",
"ecb",
"fed",
"boe"
]
},
"providers": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"endpoint": {
"type": "string"
},
"country": {
"type": "string"
},
"configured_series": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"coverage": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"freshness": {
"anyOf": [
{
"type": "object",
"properties": {
"observed_at": {
"type": "string"
},
"expires_at": {
"type": "string"
},
"age_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"meaning": {
"type": "string"
}
},
"required": [
"observed_at",
"expires_at",
"age_seconds",
"meaning"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"citation": {
"anyOf": [
{
"type": "object",
"properties": {
"url": {
"type": "string"
},
"publisher": {
"type": "string"
},
"retrieved_at": {
"type": "string"
}
},
"required": [
"url",
"publisher",
"retrieved_at"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"query": {
"type": "string"
},
"refresh_interval_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"max_collection_age_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"notice": {
"type": "string"
},
"independently_verified": {
"type": "boolean",
"const": false,
"description": "Official-source checks are not independent factual corroboration."
}
},
"required": [
"status",
"endpoint",
"country",
"configured_series",
"coverage",
"freshness",
"citation",
"query",
"refresh_interval_seconds",
"max_collection_age_seconds",
"notice",
"independently_verified"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_interest_rates(provider, series, year, date, format)
Retrieve or export central-bank policy rates in percent. provider=boe series=bank_rate since 1975; boc default overnight_target/bank_rate since 2010; ecb deposit_facility/main_refinancing/marginal_lending and historical main_refinancing_minimum_bid since 1999; fed eight series from directory with distinct starts since 1982. Latest numeric observation by default, optional year or exact date (mutually exclusive). format=csv provides a ready-to-import table with notes and provenance. No date filling, inferred announcement dates or retail quotes. Historical instruments are not current rates. Original source data free; not independently verified.
輸入結構描述
{
"type": "object",
"properties": {
"provider": {
"default": "boc",
"type": "string",
"enum": [
"boc",
"ecb",
"fed",
"boe"
]
},
"series": {
"type": "string",
"enum": [
"overnight_target",
"bank_rate",
"deposit_facility",
"main_refinancing",
"main_refinancing_minimum_bid",
"marginal_lending",
"federal_funds_target",
"federal_funds_lower",
"federal_funds_upper",
"reserve_balances",
"excess_reserves",
"required_reserves",
"primary_credit",
"overnight_reverse_repo"
]
},
"year": {
"type": "integer",
"minimum": 1975,
"maximum": 9007199254740991
},
"date": {
"type": "string"
},
"format": {
"default": "json",
"description": "CSV includes selected observations, original decimals, null flags, definitions and provenance. MCP returns CSV content alongside JSON; source-date gaps keep JSON only.",
"type": "string",
"enum": [
"json",
"csv"
]
}
},
"required": [
"series"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"source_unavailable_or_stale",
"year_not_covered",
"published_rates",
"no_numeric_data_in_period"
],
"description": "Read this before using values; a successful transport does not establish data availability."
},
"returned": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Domain-specific result count, not necessarily the number of stored records in items."
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"domain": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {},
"description": "Source-specific payload; inspect units, observation dates, nulls and source notes."
},
"freshness": {
"type": "object",
"properties": {
"observed_at": {
"type": "string"
},
"expires_at": {
"type": "string"
},
"age_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"meaning": {
"type": "string"
}
},
"required": [
"observed_at",
"expires_at",
"age_seconds",
"meaning"
],
"additionalProperties": false
},
"citation": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"publisher": {
"type": "string"
},
"retrieved_at": {
"type": "string"
}
},
"required": [
"url",
"publisher",
"retrieved_at"
],
"additionalProperties": false
},
"provenance": {
"type": "object",
"properties": {
"source_id": {
"type": "string"
},
"source_name": {
"type": "string"
},
"source_url": {
"type": "string"
},
"license": {
"type": "string"
},
"retrieved_at": {
"type": "string"
},
"verified_at": {
"type": "string"
},
"valid_until": {
"type": "string"
},
"verification_method": {
"type": "string"
},
"content_sha256": {
"type": "string"
},
"verification_level": {
"type": "string",
"enum": [
"official_source_and_schema_checked",
"public_aggregator_and_schema_checked",
"method_specific"
]
},
"independently_verified": {
"type": "boolean",
"const": false,
"description": "Official-source checks are not independent factual corroboration."
},
"verification_scope": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"source_id",
"source_name",
"source_url",
"license",
"retrieved_at",
"verified_at",
"valid_until",
"verification_method",
"content_sha256",
"verification_level",
"independently_verified",
"verification_scope"
],
"additionalProperties": false
},
"display_label": {
"type": "string"
}
},
"required": [
"id",
"domain",
"data",
"freshness",
"citation",
"provenance"
],
"additionalProperties": {}
}
},
"independently_verified": {
"type": "boolean",
"const": false,
"description": "Official-source checks are not independent factual corroboration."
},
"notice": {
"type": "string"
},
"directory": {
"type": "string"
},
"available_years": {
"type": "array",
"items": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"series": {
"type": "string"
},
"requested_date": {
"type": [
"string",
"null"
]
},
"latest_only": {
"type": "boolean"
}
},
"required": [
"status",
"returned",
"items"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}🟢list_economic_indicators
Eurostat EU/EFTA country codes and monthly/quarterly economic series since 2020. Includes latest published periods, source definitions, units and collection status. Country codes differ from World Bank; Greece is EL.
輸入結構描述
{
"type": "object",
"properties": {}
}輸出結構描述
{
"type": "object",
"properties": {
"source": {
"type": "string"
},
"endpoint": {
"type": "string"
},
"country_code_system": {
"type": "string"
},
"countries": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"code",
"name"
],
"additionalProperties": false
}
},
"configured_country_allowlist": {
"type": "array",
"items": {
"type": "string"
}
},
"indicators": {
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
}
},
"required": [
"key"
],
"additionalProperties": {}
}
},
"period": {
"type": "string"
},
"refresh_interval_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"max_collection_age_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"collection": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"independently_verified": {
"type": "boolean",
"const": false,
"description": "Official-source checks are not independent factual corroboration."
}
},
"required": [
"source",
"endpoint",
"country_code_system",
"countries",
"configured_country_allowlist",
"indicators",
"period",
"refresh_interval_seconds",
"max_collection_age_seconds",
"collection",
"independently_verified"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_economic_indicators(country, indicator, limit, language)
Eurostat HICP annual inflation rate (monthly), seasonally adjusted unemployment rate (monthly), or real GDP growth over the previous quarter (quarterly). EU/EFTA only, since 2020 through latest published periods. Source flags, missing cells, units and evidence retained. Use list_economic_indicators for countries; not real-time or independently verified.
輸入結構描述
{
"type": "object",
"properties": {
"country": {
"type": "string",
"description": "Eurostat EU/EFTA country code from list_economic_indicators, for example FR or EL for Greece; not a World Bank three-character code."
},
"indicator": {
"type": "string",
"enum": [
"inflation",
"unemployment",
"gdp_growth"
],
"description": "Eurostat series key from list_economic_indicators; check frequency, units and adjustment."
},
"limit": {
"default": 24,
"description": "Maximum latest monthly or quarterly observations returned, default 24.",
"type": "integer",
"minimum": 1,
"maximum": 240
},
"language": {
"default": "en",
"description": "Response metadata language: en or fr; original source notes are preserved.",
"type": "string",
"enum": [
"en",
"fr"
]
}
},
"required": [
"country",
"indicator"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"source_unavailable_or_stale",
"available_in_scoped_coverage",
"no_data_in_period"
]
},
"returned": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"country": {
"type": "string"
},
"indicator": {
"type": "string"
},
"directory": {
"type": "string"
},
"record": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"domain": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {},
"description": "Source-specific payload; inspect units, observation dates, nulls and source notes."
},
"freshness": {
"type": "object",
"properties": {
"observed_at": {
"type": "string"
},
"expires_at": {
"type": "string"
},
"age_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"meaning": {
"type": "string"
}
},
"required": [
"observed_at",
"expires_at",
"age_seconds",
"meaning"
],
"additionalProperties": false
},
"citation": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"publisher": {
"type": "string"
},
"retrieved_at": {
"type": "string"
}
},
"required": [
"url",
"publisher",
"retrieved_at"
],
"additionalProperties": false
},
"provenance": {
"type": "object",
"properties": {
"source_id": {
"type": "string"
},
"source_name": {
"type": "string"
},
"source_url": {
"type": "string"
},
"license": {
"type": "string"
},
"retrieved_at": {
"type": "string"
},
"verified_at": {
"type": "string"
},
"valid_until": {
"type": "string"
},
"verification_method": {
"type": "string"
},
"content_sha256": {
"type": "string"
},
"verification_level": {
"type": "string",
"enum": [
"official_source_and_schema_checked",
"public_aggregator_and_schema_checked",
"method_specific"
]
},
"independently_verified": {
"type": "boolean",
"const": false,
"description": "Official-source checks are not independent factual corroboration."
},
"verification_scope": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"source_id",
"source_name",
"source_url",
"license",
"retrieved_at",
"verified_at",
"valid_until",
"verification_method",
"content_sha256",
"verification_level",
"independently_verified",
"verification_scope"
],
"additionalProperties": false
},
"display_label": {
"type": "string"
}
},
"required": [
"id",
"domain",
"data",
"freshness",
"citation",
"provenance"
],
"additionalProperties": {}
},
"interpretation": {
"type": "object",
"properties": {
"independently_verified": {
"type": "boolean",
"const": false,
"description": "Official-source checks are not independent factual corroboration."
}
},
"required": [
"independently_verified"
],
"additionalProperties": {}
}
},
"required": [
"status",
"returned",
"country",
"indicator"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_indicators(country, indicator, language)
Annual population, GDP in current US dollars and CPI inflation from World Bank WDI worldwide economies. Use list_countries for supported three-character codes. Five completed years only, not real-time. Returns units, definitions, producers, footnotes and provenance. Null is missing, never zero. Not independently verified.
輸入結構描述
{
"type": "object",
"properties": {
"country": {
"type": "string",
"pattern": "^[A-Z0-9]{3}$",
"description": "World Bank three-character economy code from list_countries, for example USA or FRA."
},
"indicator": {
"description": "Optional annual series: population, gdp (current USD), or inflation (annual CPI percent). Omit for all three.",
"type": "string",
"enum": [
"population",
"gdp",
"inflation"
]
},
"language": {
"default": "en",
"description": "Response metadata language: en or fr; original producer attribution is preserved.",
"type": "string",
"enum": [
"en",
"fr"
]
}
},
"required": [
"country"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"source_unavailable",
"country_not_supported",
"source_stale",
"available_in_scoped_coverage",
"partially_unavailable"
],
"description": "Read this before using values; a successful transport does not establish data availability."
},
"returned": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Domain-specific result count, not necessarily the number of stored records in items."
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"domain": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {},
"description": "Source-specific payload; inspect units, observation dates, nulls and source notes."
},
"freshness": {
"type": "object",
"properties": {
"observed_at": {
"type": "string"
},
"expires_at": {
"type": "string"
},
"age_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"meaning": {
"type": "string"
}
},
"required": [
"observed_at",
"expires_at",
"age_seconds",
"meaning"
],
"additionalProperties": false
},
"citation": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"publisher": {
"type": "string"
},
"retrieved_at": {
"type": "string"
}
},
"required": [
"url",
"publisher",
"retrieved_at"
],
"additionalProperties": false
},
"provenance": {
"type": "object",
"properties": {
"source_id": {
"type": "string"
},
"source_name": {
"type": "string"
},
"source_url": {
"type": "string"
},
"license": {
"type": "string"
},
"retrieved_at": {
"type": "string"
},
"verified_at": {
"type": "string"
},
"valid_until": {
"type": "string"
},
"verification_method": {
"type": "string"
},
"content_sha256": {
"type": "string"
},
"verification_level": {
"type": "string",
"enum": [
"official_source_and_schema_checked",
"public_aggregator_and_schema_checked",
"method_specific"
]
},
"independently_verified": {
"type": "boolean",
"const": false,
"description": "Official-source checks are not independent factual corroboration."
},
"verification_scope": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"source_id",
"source_name",
"source_url",
"license",
"retrieved_at",
"verified_at",
"valid_until",
"verification_method",
"content_sha256",
"verification_level",
"independently_verified",
"verification_scope"
],
"additionalProperties": false
},
"display_label": {
"type": "string"
}
},
"required": [
"id",
"domain",
"data",
"freshness",
"citation",
"provenance"
],
"additionalProperties": {}
}
},
"independently_verified": {
"type": "boolean",
"const": false,
"description": "Official-source checks are not independent factual corroboration."
},
"notice": {
"type": "string"
},
"directory": {
"type": "string"
},
"as_of": {
"type": "string"
},
"country": {
"type": "string"
},
"language": {
"type": "string",
"enum": [
"en",
"fr"
]
},
"coverage": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"interpretation": {
"type": "object",
"properties": {
"independently_verified": {
"type": "boolean",
"const": false,
"description": "Official-source checks are not independent factual corroboration."
}
},
"required": [
"independently_verified"
],
"additionalProperties": {}
}
},
"required": [
"status",
"returned",
"items",
"as_of",
"country",
"language",
"coverage",
"interpretation"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}🟢list_countries
List economies and territories available for annual indicators. Aggregated regions are excluded. Coverage and missing values vary by indicator.
輸入結構描述
{
"type": "object",
"properties": {}
}輸出結構描述
{
"type": "object",
"properties": {
"countries": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"iso2": {
"type": "string"
},
"name": {
"type": "string"
},
"region": {
"type": "string"
}
},
"required": [
"code",
"iso2",
"name",
"region"
],
"additionalProperties": false
}
},
"count": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"retrieved_at": {
"type": [
"string",
"null"
]
},
"scope": {
"type": "string"
}
},
"required": [
"countries",
"count",
"retrieved_at",
"scope"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢list_historical_indicators
List twenty-two annual World Bank historical series, units, definitions via records, and latest collection status. Coverage starts in 1960 with missing years preserved. Not real-time.
輸入結構描述
{
"type": "object",
"properties": {}
}輸出結構描述
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"code": {
"type": "string"
},
"en": {
"type": "string"
},
"fr": {
"type": "string"
},
"collection": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
}
},
"required": [
"key",
"code",
"en",
"fr",
"collection"
],
"additionalProperties": {}
}
},
"period": {
"type": "object",
"properties": {
"from": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"to": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"required": [
"from",
"to"
],
"additionalProperties": false
},
"coverage": {
"type": "string"
},
"refresh": {
"type": "string"
},
"independently_verified": {
"type": "boolean",
"const": false,
"description": "Official-source checks are not independent factual corroboration."
}
},
"required": [
"items",
"period",
"coverage",
"refresh",
"independently_verified"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_historical_indicators(format, country, indicator, from, to, ...)
Annual historical series for one World Bank country and indicator from 1960 to the last completed year. Use list_historical_indicators for keys and list_countries for countries. Choose GDP per capita, current dollars or constant 2015 dollars explicitly; these are not interchangeable. Nulls are missing, not zero. Provenance and original definitions included; not independently verified.
輸入結構描述
{
"type": "object",
"properties": {
"format": {
"default": "json",
"description": "CSV content with null flags, original values, source notes and provenance, alongside JSON. No missing-date filling.",
"type": "string",
"enum": [
"json",
"csv"
]
},
"country": {
"type": "string",
"pattern": "^[A-Z0-9]{3}$",
"description": "World Bank three-character economy code from list_countries, for example USA or FRA."
},
"indicator": {
"type": "string",
"enum": [
"population",
"gdp",
"gdp_per_capita",
"gdp_real",
"gdp_growth",
"inflation",
"life_expectancy",
"fertility",
"urban_population",
"internet_users",
"electricity_access",
"unemployment",
"renewable_energy",
"forest_area",
"agricultural_land",
"trade",
"exports",
"imports",
"infant_mortality",
"basic_drinking_water",
"basic_sanitation",
"primary_completion"
],
"description": "Annual series key from list_historical_indicators, for example gdp_per_capita; inspect units before comparing."
},
"from": {
"default": 1960,
"description": "Inclusive first observation year, at least 1960 and no later than to.",
"type": "integer",
"minimum": 1960,
"maximum": 2025
},
"to": {
"default": 2025,
"description": "Inclusive last observation year, no later than the last completed calendar year. Available data may end earlier.",
"type": "integer",
"minimum": 1960,
"maximum": 2025
},
"language": {
"default": "en",
"description": "Response metadata language: en or fr; original definitions and source notes are preserved.",
"type": "string",
"enum": [
"en",
"fr"
]
}
},
"required": [
"country",
"indicator"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"source_unavailable_or_stale",
"available_historical_series",
"no_numeric_data_in_period"
],
"description": "Read this before using values; a successful transport does not establish data availability."
},
"returned": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Domain-specific result count, not necessarily the number of stored records in items."
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"domain": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {},
"description": "Source-specific payload; inspect units, observation dates, nulls and source notes."
},
"freshness": {
"type": "object",
"properties": {
"observed_at": {
"type": "string"
},
"expires_at": {
"type": "string"
},
"age_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"meaning": {
"type": "string"
}
},
"required": [
"observed_at",
"expires_at",
"age_seconds",
"meaning"
],
"additionalProperties": false
},
"citation": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"publisher": {
"type": "string"
},
"retrieved_at": {
"type": "string"
}
},
"required": [
"url",
"publisher",
"retrieved_at"
],
"additionalProperties": false
},
"provenance": {
"type": "object",
"properties": {
"source_id": {
"type": "string"
},
"source_name": {
"type": "string"
},
"source_url": {
"type": "string"
},
"license": {
"type": "string"
},
"retrieved_at": {
"type": "string"
},
"verified_at": {
"type": "string"
},
"valid_until": {
"type": "string"
},
"verification_method": {
"type": "string"
},
"content_sha256": {
"type": "string"
},
"verification_level": {
"type": "string",
"enum": [
"official_source_and_schema_checked",
"public_aggregator_and_schema_checked",
"method_specific"
]
},
"independently_verified": {
"type": "boolean",
"const": false,
"description": "Official-source checks are not independent factual corroboration."
},
"verification_scope": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"source_id",
"source_name",
"source_url",
"license",
"retrieved_at",
"verified_at",
"valid_until",
"verification_method",
"content_sha256",
"verification_level",
"independently_verified",
"verification_scope"
],
"additionalProperties": false
},
"display_label": {
"type": "string"
}
},
"required": [
"id",
"domain",
"data",
"freshness",
"citation",
"provenance"
],
"additionalProperties": {}
}
},
"independently_verified": {
"type": "boolean",
"const": false,
"description": "Official-source checks are not independent factual corroboration."
},
"notice": {
"type": "string"
},
"directory": {
"type": "string"
}
},
"required": [
"status",
"returned",
"items"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}🟢get_record(id)
Get an unexpired record with provenance and its explicit verification level. Source/schema validation is not independent factual verification.
輸入結構描述
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9_-]+$",
"description": "Opaque record id returned by a DatoQA data response. Reuse it exactly; do not invent an id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"domain": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {},
"description": "Source-specific payload; inspect units, observation dates, nulls and source notes."
},
"freshness": {
"type": "object",
"properties": {
"observed_at": {
"type": "string"
},
"expires_at": {
"type": "string"
},
"age_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"meaning": {
"type": "string"
}
},
"required": [
"observed_at",
"expires_at",
"age_seconds",
"meaning"
],
"additionalProperties": false
},
"citation": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"publisher": {
"type": "string"
},
"retrieved_at": {
"type": "string"
}
},
"required": [
"url",
"publisher",
"retrieved_at"
],
"additionalProperties": false
},
"provenance": {
"type": "object",
"properties": {
"source_id": {
"type": "string"
},
"source_name": {
"type": "string"
},
"source_url": {
"type": "string"
},
"license": {
"type": "string"
},
"retrieved_at": {
"type": "string"
},
"verified_at": {
"type": "string"
},
"valid_until": {
"type": "string"
},
"verification_method": {
"type": "string"
},
"content_sha256": {
"type": "string"
},
"verification_level": {
"type": "string",
"enum": [
"official_source_and_schema_checked",
"public_aggregator_and_schema_checked",
"method_specific"
]
},
"independently_verified": {
"type": "boolean",
"const": false,
"description": "Official-source checks are not independent factual corroboration."
},
"verification_scope": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"source_id",
"source_name",
"source_url",
"license",
"retrieved_at",
"verified_at",
"valid_until",
"verification_method",
"content_sha256",
"verification_level",
"independently_verified",
"verification_scope"
],
"additionalProperties": false
},
"display_label": {
"type": "string"
}
},
"required": [
"id",
"domain",
"data",
"freshness",
"citation",
"provenance"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}🟢get_evidence(id)
Retrieve the source JSON snapshot and SHA-256 digest for a currently available record. The digest proves snapshot integrity, not factual truth.
輸入結構描述
{
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,128}$",
"description": "Record id returned by a DatoQA data response; returns the retained source snapshot for that record."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"record_id": {
"type": "string"
},
"sha256": {
"type": "string"
},
"hash_scope": {
"type": "string",
"const": "utf8_source_payload_json"
},
"source_payload_json": {
"type": "string"
},
"first_observed_at": {
"type": "string"
},
"source_url": {
"type": "string"
},
"notice": {
"type": "string"
}
},
"required": [
"record_id",
"sha256",
"hash_scope",
"source_payload_json",
"first_observed_at",
"source_url",
"notice"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}社群
證據
近期觀測
已驗證未記錄版本13 個工具