{"openapi":"3.1.0","info":{"title":"Klion API","version":"1.0.0","description":"Real-time API for Spanish CNMV regulatory disclosures, inside information (información privilegiada), and issuer directory.","contact":{"name":"Klion Developer Support","url":"https://getklion.com/developers","email":"info@getklion.com"},"license":{"name":"Proprietary / Free Public Access","url":"https://getklion.com/legal"}},"servers":[{"url":"https://getklion.com","description":"Production Server"}],"paths":{"/api/v1/reports":{"get":{"summary":"Search and list regulatory disclosures","description":"Query official CNMV disclosures and inside information with real-time updates (<2 seconds latency).","operationId":"getReports","parameters":[{"name":"search","in":"query","description":"Free text search by company name, ticker symbol, or keywords (e.g. dividendo, OPA).","required":false,"schema":{"type":"string"}},{"name":"type","in":"query","description":"Filter by regulatory category: IP (Información Privilegiada), HR (Hecho Relevante), OIR (Otra Información Relevante).","required":false,"schema":{"type":"string","enum":["IP","HR","OIR"]}},{"name":"limit","in":"query","description":"Maximum number of reports to return (1-50, default 10).","required":false,"schema":{"type":"integer","default":10,"minimum":1,"maximum":50}},{"name":"page","in":"query","description":"Pagination page number (starts at 1).","required":false,"schema":{"type":"integer","default":1}}],"responses":{"200":{"description":"Successful query of disclosures","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Report"}},"total":{"type":"integer"},"page":{"type":"integer"},"limit":{"type":"integer"}}}}}}}}},"/api/v1/issuers":{"get":{"summary":"Search listed entities and CNMV issuers","description":"Look up companies, investment funds (IIC), and asset managers (SGIIC) registered with CNMV.","operationId":"getIssuers","parameters":[{"name":"search","in":"query","description":"Search term matching company name, ticker, or CIF identifier.","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Max results (1-50, default 10).","required":false,"schema":{"type":"integer","default":10}}],"responses":{"200":{"description":"Successful issuer query","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Issuer"}}}}}}}}}},"/api/v1/analytics":{"get":{"summary":"Get aggregate market statistics","description":"Retrieve daily filing distribution and activity statistics across Spanish equity markets.","operationId":"getAnalytics","responses":{"200":{"description":"Summary analytics","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/mcp":{"post":{"summary":"Model Context Protocol JSON-RPC endpoint","description":"Standard MCP server endpoint supporting tools, resources, and MCP Apps interactive UIs (ext-apps).","operationId":"mcpJsonRpc","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"jsonrpc":{"type":"string","example":"2.0"},"method":{"type":"string","example":"tools/list"},"params":{"type":"object"},"id":{"type":"string","example":"1"}}}}}},"responses":{"200":{"description":"MCP response with result or error","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"components":{"schemas":{"Report":{"type":"object","properties":{"id":{"type":"string"},"company_name":{"type":"string"},"ticker":{"type":"string","nullable":true},"type":{"type":"string","enum":["IP","HR","OIR"]},"title":{"type":"string"},"summary":{"type":"string","nullable":true},"published_at":{"type":"string","format":"date-time"},"cnmv_registration_number":{"type":"string"},"pdf_url":{"type":"string","format":"uri","nullable":true}}},"Issuer":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"cif":{"type":"string","nullable":true},"ticker":{"type":"string","nullable":true},"market":{"type":"string","nullable":true}}}},"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"},"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}}},"security":[{},{"ApiKeyAuth":[]},{"BearerAuth":[]}]}