{
  "openapi": "3.0.3",
  "info": { "title": "Global Market Model Demo API", "version": "1.0.0", "description": "Client demonstration schema for GMM markets, market values, and reports. Production access uses JWT authentication." },
  "paths": {
    "/api/demomarkets": { "get": { "summary": "List demonstration markets", "parameters": [{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"pageSize","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":30}}], "responses": { "200": { "description": "Market hierarchy", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MarketListResponse" } } } } } } },
    "/api/marketdatademo": { "get": { "summary": "Retrieve demonstration market values", "parameters": [{"name":"marketId","in":"query","schema":{"type":"integer"}},{"name":"marketName","in":"query","schema":{"type":"string"}},{"name":"geography","in":"query","schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"pageSize","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":30}}], "responses": { "200": { "description": "Historic and forecast market values", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MarketDataResponse" } } } } } } },
    "/api/demoreports": { "get": { "summary": "Search demonstration reports", "parameters": [{"name":"category","in":"query","schema":{"type":"string"}},{"name":"fromDate","in":"query","schema":{"type":"string","format":"date"}},{"name":"toDate","in":"query","schema":{"type":"string","format":"date"}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"pageSize","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":30}}], "responses": { "200": { "description": "Published market reports", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReportListResponse" } } } } } } }
  },
  "components": { "schemas": {
    "Market": { "type":"object", "required":["marketId","marketName","level"], "properties":{"marketId":{"type":"integer"},"marketName":{"type":"string"},"parentMarketId":{"type":"integer","nullable":true},"level":{"type":"integer"}} },
    "MarketData": { "type":"object", "required":["marketId","marketName","geography","year","periodType","value","currency","unit"], "properties":{"marketId":{"type":"integer","example":196},"marketName":{"type":"string","example":"Batteries"},"parentMarketId":{"type":"integer","nullable":true,"example":38},"geography":{"type":"object","properties":{"id":{"type":"integer","example":101},"name":{"type":"string","example":"India"},"type":{"type":"string","example":"country"}}},"year":{"type":"integer","example":2025},"periodType":{"type":"string","enum":["historic","forecast"]},"value":{"type":"number","format":"decimal","example":11.5},"currency":{"type":"string","example":"USD"},"unit":{"type":"string","example":"billion"}} },
    "Report": { "type":"object", "required":["reportId","title","category","publishedDate","reportType"], "properties":{"reportId":{"type":"integer","example":5804},"title":{"type":"string","example":"Batteries Global Market Briefing 2026"},"category":{"type":"object","properties":{"id":{"type":"integer","example":5},"name":{"type":"string","example":"Electrical And Electronics"}}},"publishedDate":{"type":"string","format":"date","example":"2026-03-23"},"reportType":{"type":"string","example":"Global Market Briefing"},"coverage":{"type":"array","items":{"type":"string"}},"previewUrl":{"type":"string","example":"/reports/5804/preview"}} },
    "MarketListResponse": { "type":"object", "properties":{"success":{"type":"boolean"},"totalCount":{"type":"integer"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Market"}}} },
    "MarketDataResponse": { "type":"object", "properties":{"success":{"type":"boolean"},"data":{"type":"array","items":{"$ref":"#/components/schemas/MarketData"}}} },
    "ReportListResponse": { "type":"object", "properties":{"success":{"type":"boolean"},"totalCount":{"type":"integer"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Report"}}} }
  } }
}
