{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://x402-report-store.app.workbuddy.host/schema/report.json","title":"agentshop report payloads","description":"Two payloads share this document. `preview` is free from GET /preview/{id}: the latest-year cross-section for every economy plus the field dictionary. `report` is paid from GET /report/{id}?format=json: the same shape extended with the full year-by-year panel and every derived metric.","oneOf":[{"$ref":"#/$defs/preview"},{"$ref":"#/$defs/report"}],"$defs":{"seriesPoint":{"type":"object","properties":{"year":{"type":"integer"},"value":{"type":"number"}},"required":["year","value"],"additionalProperties":false},"dataQuality":{"type":"object","properties":{"published":{"type":"integer"},"expected":{"type":["integer","null"]},"coveragePct":{"type":["number","null"]},"missingYears":{"type":"array","items":{"type":"integer"}},"latestLagYears":{"type":["integer","null"]}},"required":["published"]},"reportIndicatorBlock":{"type":"object","required":["code","label","rows"],"properties":{"code":{"type":"string"},"label":{"type":"string"},"kind":{"enum":["usd","count","pct","index"]},"polarity":{"enum":["neutral","inverse"]},"sparseNote":{"type":["string","null"]},"economies":{"type":"integer"},"latestYear":{"type":["integer","null"]},"group":{"type":"object"},"rows":{"type":"array","items":{"type":"object","required":["code","name","rank","lastYear","lastValue"],"properties":{"series":{"type":"array","items":{"$ref":"#/$defs/seriesPoint"},"description":"Complete year-by-year panel."},"meanLevel":{"type":["number","null"],"description":"Mean of the annual readings."},"cagr":{"type":["number","null"],"description":"Compound annual growth, %. Null for rate indicators."},"growthIndex":{"type":["number","null"],"description":"Last year as a % of the first year. Null for rate indicators and for series crossing zero."},"latestYoy":{"type":["number","null"]},"avgYoy":{"type":["number","null"]},"volatility":{"type":["number","null"],"description":"Standard deviation of year-over-year change, percentage points."},"trendSlope":{"type":["number","null"]},"trendSlopePct":{"type":["number","null"]},"trendSlopePp":{"type":["number","null"]},"trendR2":{"type":["number","null"]},"momentumPp":{"type":["number","null"]},"halfPeriodShiftPp":{"type":["number","null"]},"outlierYears":{"type":"array","items":{"type":"object","properties":{"year":{"type":"integer"},"pct":{"type":"number"},"z":{"type":"number"}}}},"share":{"type":["number","null"]},"percentile":{"type":"number"},"rank":{"type":"integer"},"code":{"type":"string"},"name":{"type":"string"},"points":{"type":"integer"},"firstYear":{"type":"integer"},"firstValue":{"type":"number"},"lastYear":{"type":"integer"},"lastValue":{"type":"number"},"min":{"type":"number"},"max":{"type":"number"},"range":{"type":"number"},"peak":{"type":"object","properties":{"year":{"type":"integer"},"value":{"type":"number"}}},"trough":{"type":"object","properties":{"year":{"type":"integer"},"value":{"type":"number"}}},"dataQuality":{"$ref":"#/$defs/dataQuality"}}}}}},"preview":{"type":"object","required":["kind","report","crossSection"],"properties":{"schemaVersion":{"type":"string"},"kind":{"const":"preview"},"generatedAt":{"type":"string","format":"date-time"},"report":{"type":"object"},"latestYear":{"type":["integer","null"]},"coveragePct":{"type":["number","null"]},"crossSection":{"type":"array","items":{"type":"object","required":["indicator","rows"],"properties":{"indicator":{"type":"string"},"indicatorLabel":{"type":"string"},"kind":{"type":"string"},"polarity":{"type":"string"},"sparseNote":{"type":["string","null"]},"latestYear":{"type":["integer","null"]},"group":{"type":"object"},"rows":{"type":"array","items":{"type":"object","required":["economy","economyName","year","value","rank","percentile"],"properties":{"economy":{"type":"string"},"economyName":{"type":"string"},"year":{"type":"integer"},"value":{"type":"number"},"rank":{"type":"integer"},"percentile":{"type":"number"}}}}}}},"schema":{"type":"object"},"paidAdds":{"type":"array","items":{"type":"string"}},"purchase":{"type":"object"}}},"report":{"type":"object","required":["kind","report","indicators"],"properties":{"schemaVersion":{"type":"string"},"kind":{"const":"report"},"generatedAt":{"type":"string","format":"date-time"},"report":{"type":"object"},"licence":{"type":"object"},"purchase":{"type":["object","null"]},"totals":{"type":"object"},"indicators":{"type":"array","items":{"$ref":"#/$defs/reportIndicatorBlock"}},"crossCorrelations":{"type":"array","items":{"type":"object","properties":{"indicatorA":{"type":"string"},"indicatorB":{"type":"string"},"labelA":{"type":"string"},"labelB":{"type":"string"},"r":{"type":["number","null"]},"n":{"type":"integer"},"direction":{"enum":["positive","negative","weak","undetermined"]},"note":{"type":"string"}}}},"notes":{"type":"object"}}}}}