cloudy_day@orbit:~/api$ curl https://www.chyp.ai/api/v1
ORBIT public API
Free, read-only JSON of everything ORBIT Pulse aggregates: KEV, CVEs, EPSS, ATT&CK, outages, threat aggregates, headlines, breaches. No key, no sign-up, CORS open. Please cache what you fetch, stay under 120 requests per minute per IP, and credit ORBIT and the original sources.
Quick start
curl -s "https://www.chyp.ai/api/v1/kev?days=7" | jq '.data[] | {cve, vendor, dateAdded}'const r = await fetch("https://www.chyp.ai/api/v1/kev?days=7");
const { data, updatedAt } = await r.json();
console.log(data.length, "KEV entries this week");import requests
r = requests.get("https://www.chyp.ai/api/v1/kev?days=7", timeout=10)
r.raise_for_status()
for v in r.json()["data"]:
print(v["cve"], v["vendor"], v["dateAdded"])Machine-readable spec: /api/v1/openapi.json (OpenAPI 3.1). Endpoint index: /api/v1.
Endpoints
GET /api/v1
Index of endpoints. Cached 3600 s.
Example response
{
"ok": true,
"version": "1",
"generatedAt": "2026-11-20T21:00:00.000Z",
"data": {
"version": "1",
"endpoints": [
{
"path": "/api/v1/kev",
"params": [
"days",
"limit"
],
"cacheSeconds": 300
}
]
}
}GET /api/v1/kev
CISA KEV entries added in the last N days, with ATT&CK techniques where mapped. Cached 300 s.
daysinteger 1-365, default 30: Look-back window in dayslimitinteger 1-500, default 100: Max items (1-500)
Example response
{
"ok": true,
"version": "1",
"generatedAt": "2026-11-20T21:00:00.000Z",
"data": [
{
"cve": "CVE-2026-12345",
"vendor": "Example",
"product": "Gateway",
"dateAdded": "2026-11-20",
"ransomwareUse": "Unknown",
"cwes": [
"CWE-78"
],
"attack": [
{
"id": "T1190",
"name": "Exploit Public-Facing Application"
}
]
}
]
}GET /api/v1/kev/summary
KEV totals, monthly additions, top vendors, ransomware-use share. Cached 300 s.
Example response
{
"ok": true,
"version": "1",
"generatedAt": "2026-11-20T21:00:00.000Z",
"data": {
"total": 1790,
"last7": 9,
"topVendors": [
[
"Microsoft",
360
]
]
}
}GET /api/v1/cves/recent
CVEs published in the last 24 h by severity, plus the newest CVEs (NVD). Cached 300 s.
Example response
{
"ok": true,
"version": "1",
"generatedAt": "2026-11-20T21:00:00.000Z",
"data": {
"total": 738,
"bySeverity": {
"CRITICAL": 2,
"HIGH": 40
}
}
}GET /api/v1/epss
Highest EPSS scores today, and EPSS for the newest KEV entries (FIRST). Cached 600 s.
Example response
{
"ok": true,
"version": "1",
"generatedAt": "2026-11-20T21:00:00.000Z",
"data": {
"top": [
{
"cve": "CVE-2026-0001",
"epss": 0.97,
"percentile": 1
}
]
}
}GET /api/v1/attack
Top MITRE ATT&CK tactics and techniques behind KEV additions (7 and 30 days). Cached 600 s.
Example response
{
"ok": true,
"version": "1",
"generatedAt": "2026-11-20T21:00:00.000Z",
"data": {
"d7": {
"tactics": [
[
"initial-access",
5
]
],
"techniques": [
[
"T1190",
5
]
]
}
}
}GET /api/v1/outages
Tracked services whose own status page reports a problem, and open incidents. Cached 60 s.
Example response
{
"ok": true,
"version": "1",
"generatedAt": "2026-11-20T21:00:00.000Z",
"data": {
"reporting": [
{
"service": "zoom",
"indicator": "maintenance",
"description": "Service Under Maintenance"
}
],
"openIncidents": []
}
}GET /api/v1/threats/summary
Aggregates only: SANS ISC InfoCon and top ports, phishing by brand/TLD, botnet C2 count by country, Exploit-DB index counts. Cached 300 s.
Example response
{
"ok": true,
"version": "1",
"generatedAt": "2026-11-20T21:00:00.000Z",
"data": {
"isc": {
"infocon": "green"
},
"phishing": {
"online": 43298
},
"botnetC2": {
"total": 5,
"byCountry": {
"US": 2
}
}
}
}GET /api/v1/news
Latest security headlines (links to the publisher). Cached 120 s.
catone ofbreakingvulnsbreachesoutagesgovintel: News categorylimitinteger 1-200, default 50: Max items (1-200)
Example response
{
"ok": true,
"version": "1",
"generatedAt": "2026-11-20T21:00:00.000Z",
"data": [
{
"id": "a1b2c3d4",
"title": "Example headline",
"url": "https://publisher.example/story",
"source": "Publisher",
"category": "vulns",
"cves": [],
"kev": false
}
]
}GET /api/v1/breaches
Have I Been Pwned breach totals and newest breaches (organisation level only). Cached 900 s.
Example response
{
"ok": true,
"version": "1",
"generatedAt": "2026-11-20T21:00:00.000Z",
"data": {
"breaches": 1054,
"accounts": 17862709990
}
}GET /api/v1/internet
Certificate Transparency volume, BGP table size, OSV advisory activity. Cached 300 s.
Example response
{
"ok": true,
"version": "1",
"generatedAt": "2026-11-20T21:00:00.000Z",
"data": {
"ct": {
"logs": 15,
"entries": 31180212928
},
"bgp": {
"v4": 1170724
}
}
}GET /api/v1/daily
Daily snapshot cards (last 30 days). Cached 600 s.
Example response
{
"ok": true,
"version": "1",
"generatedAt": "2026-11-20T21:00:00.000Z",
"data": [
{
"day": "2026-11-20",
"card": "https://www.chyp.ai/card/daily/2026-11-20.svg"
}
]
}GET /api/v1/sources
Every data source with licence, cadence, status and last pull. Cached 3600 s.
Example response
{
"ok": true,
"version": "1",
"generatedAt": "2026-11-20T21:00:00.000Z",
"data": [
{
"id": "kev",
"name": "CISA KEV",
"licence": "Public domain",
"status": "live"
}
]
}GET /api/v1/last-resort
The Last Resort: aggregate, unverified statistics from researchers' stalled disclosure cases (owner-approved cases only; organizations named only with 3+ independent reports). Cached 120 s.
Example response
{
"ok": true,
"version": "1",
"generatedAt": "2026-11-20T21:00:00.000Z",
"data": {
"approvedCases": 0,
"awaitingReview": 0,
"rates": {
"respondedPct": null
},
"bySector": [],
"byProgram": [],
"byClass": [],
"trend": [
{
"month": "2026-11",
"reported": 0,
"received": 0
}
],
"named": []
}
}GET /api/v1/openapi.json
OpenAPI 3.1 description of this API. Cached 3600 s.
Responses and errors
Every success is { ok: true, version, generatedAt, updatedAt?, data, attribution }. Errors are always { ok: false, version, error: { status, code, message }, docs } with codes bad_param (400), not_found (404), method_not_allowed (405), rate_limited (429, with Retry-After), unavailable/disabled (503). Unknown or out-of-range parameters are rejected, not ignored. Responses carry ETag (send If-None-Match for a cheap 304) and X-RateLimit-* headers.
Privacy and safety
- GET only; nothing you send is stored. The rate limiter keeps a salted hash of your IP in memory for one minute, with a salt that changes daily; IPs are never logged or persisted by the API.
- No personal data. No raw indicators (no IPs, malicious URLs, hashes or samples) and no exploit code: aggregates and public catalogue entries only.
- No lookups of third-party hosts, IPs or domains, and no scanning.
- Versioned under
/api/v1; breaking changes would go to/api/v2.
Also available: /api/pulse.json, RSS, JSON Feed. Sources and licences: /data/sources/. Automated analysis; correlation is not causation.