{"openapi":"3.1.0","info":{"title":"Exogeny Hive","version":"0.1.0","summary":"An exchange for publicly disclosed vulnerabilities.","description":"Prices every listed CVE from public exploitation signals (FIRST EPSS, CISA KEV, CISA SSVC, CVSS) and checks whether an environment is affected. Read-only, no authentication. An MCP server is available at /mcp.","contact":{"email":"connect@exogeny.ai","url":"https://hive.exogeny.ai"}},"servers":[{"url":"https://hive.exogeny.ai"}],"paths":{"/api/v1/check":{"post":{"operationId":"checkEnvironment","summary":"Check whether an environment is affected","description":"Send installed packages, products and/or raw manifests. Returns the vulnerabilities that apply, priced and ranked. The inventory is not stored.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckRequest"}}}},"responses":{"200":{"description":"Findings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckResult"}}}},"400":{"description":"Bad request"},"429":{"description":"Rate limited"}}}},"/api/v1/market":{"get":{"operationId":"getMarket","summary":"Market summary: index, stats, movers, sectors, feed freshness","responses":{"200":{"description":"Market","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/board":{"get":{"operationId":"getBoard","summary":"Every listing as compact rows, one part per request (cols names the columns, parts says how many parts exist). Price history is given as change points.","parameters":[{"name":"part","in":"query","required":false,"schema":{"type":"integer","minimum":0},"description":"Which part, from 0"}],"responses":{"200":{"description":"The board","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/listings":{"get":{"operationId":"listListings","summary":"Search and sort the board","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"},"description":"Free text over CVE ID, name, vendor, product"},{"name":"vendor","in":"query","required":false,"schema":{"type":"string"},"description":"Exact vendor"},{"name":"product","in":"query","required":false,"schema":{"type":"string"},"description":"Product name contains"},{"name":"kev","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Only CISA known-exploited"},{"name":"ransomware","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Only known ransomware use"},{"name":"min_price","in":"query","required":false,"schema":{"type":"number"}},{"name":"min_epss","in":"query","required":false,"schema":{"type":"number"}},{"name":"min_cvss","in":"query","required":false,"schema":{"type":"number"}},{"name":"since","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"Published on or after"},{"name":"listed_since","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"Listed on or after"},{"name":"sort","in":"query","required":false,"schema":{"type":"string","enum":["price","chg1","chg7","chg30","epss","cvss","published","kev_added","listed_on"]}},{"name":"order","in":"query","required":false,"schema":{"type":"string","enum":["desc","asc"]}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"A page of listings","content":{"application/json":{"schema":{"type":"object","properties":{"has_more":{"type":"boolean"},"listings":{"type":"array","items":{"$ref":"#/components/schemas/Listing"}}}}}}},"429":{"description":"The shared search budget is spent; retry in a minute"}}}},"/api/v1/quotes/{cve}":{"get":{"operationId":"getQuote","summary":"Quote one CVE, listed or not","parameters":[{"name":"cve","in":"path","required":true,"schema":{"type":"string","pattern":"^CVE-\\d{4}-\\d{4,7}$"}}],"responses":{"200":{"description":"Quote","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Unknown CVE"}}}},"/api/v1/movers":{"get":{"operationId":"getMovers","summary":"Biggest risers and fallers, newest listings, newest KEV additions","parameters":[{"name":"window","in":"query","required":false,"schema":{"type":"string","enum":["1d","7d","30d"]}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50}}],"responses":{"200":{"description":"Movers","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/status":{"get":{"operationId":"getStatus","summary":"Feed freshness and ingest backlog","responses":{"200":{"description":"Status","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"components":{"schemas":{"Package":{"oneOf":[{"type":"string","description":"A package URL, e.g. pkg:npm/lodash@4.17.15"},{"type":"object","properties":{"ecosystem":{"type":"string"},"name":{"type":"string"},"version":{"type":"string"},"purl":{"type":"string"}}}]},"Product":{"oneOf":[{"type":"string","description":"\"nginx 1.24.0\", \"apache:http_server 2.4.49\" or a CPE 2.3 string"},{"type":"object","properties":{"vendor":{"type":"string"},"product":{"type":"string"},"version":{"type":"string"},"cpe":{"type":"string"}}}]},"Manifest":{"type":"object","required":["content"],"properties":{"filename":{"type":"string"},"content":{"type":"string"},"ecosystem":{"type":"string"}}},"CheckRequest":{"type":"object","properties":{"packages":{"type":"array","maxItems":1000,"items":{"$ref":"#/components/schemas/Package"}},"products":{"type":"array","maxItems":100,"items":{"$ref":"#/components/schemas/Product"}},"manifests":{"type":"array","maxItems":10,"items":{"$ref":"#/components/schemas/Manifest"}},"options":{"type":"object","properties":{"min_tier":{"type":"string","enum":["act_now","schedule","monitor"]},"min_price":{"type":"number"},"limit":{"type":"integer","maximum":500}}}}},"Finding":{"type":"object","properties":{"id":{"type":"string","description":"CVE ID, or the advisory ID when no CVE exists"},"component":{"type":"object"},"status":{"type":"string","enum":["affected","possible"]},"tier":{"type":"string","enum":["act_now","schedule","monitor"]},"price":{"type":["number","null"],"description":"0-100"},"listed":{"type":"boolean"},"epss":{"type":["number","null"]},"kev":{"type":"boolean"},"ransomware":{"type":"boolean"},"cvss":{"type":["number","null"]},"fixed_in":{"type":["string","null"]},"action":{"type":"string"},"url":{"type":"string"}}},"CheckResult":{"type":"object","properties":{"verdict":{"type":"string","enum":["act_now","verify","schedule","monitor","clear","no_input"]},"summary":{"type":"object"},"findings":{"type":"array","items":{"$ref":"#/components/schemas/Finding"}},"notes":{"type":"array","items":{"type":"string"}}}},"Listing":{"type":"object","properties":{"cve":{"type":"string"},"name":{"type":"string"},"vendor":{"type":"string"},"product":{"type":"string"},"price":{"type":"number"},"chg1":{"type":"number"},"chg7":{"type":"number"},"chg30":{"type":"number"},"epss":{"type":"number"},"cvss":{"type":["number","null"]},"kev":{"type":"boolean"},"ransomware":{"type":"boolean"}}}}}}