Overview

CascadeGuard is a deterministic cascade failure simulation engine for critical infrastructure. Model how failures propagate through interconnected systems using graph-based dependency analysis, and receive explainable impact assessments, AI-powered insights, recovery planning, and compliance reporting.

Key Features

Graph-Based Modeling: 7 infrastructure types (power, water, telecom, transport, data, fuel, defense)
Deterministic BFS Algorithm: Reproducible cascade propagation with depth control
AI-Powered Insights: Natural language analysis and recommendations (Pro+)
Recovery Planning: Optimal restoration sequencing with resource allocation
Topology Scoring: Resilience grading (A-F) with vulnerability identification
Compliance Reports: NERC CIP, NIST CSF, ISO 27001, IEC 62443, CISA
Batch Processing: Up to 25 scenarios per request

Pricing Tiers

Tier	RapidAPI Plan	Simulations/mo	Max Assets	Max Dependencies	Key Features
Free	BASIC	50	50	100	Simulate, Analyze, Schema, Sector Templates
Starter	STARTER	5,000	200	1,000	+ Recovery, Topology, Compare, What-If, Profiles, Webhooks, Audit
Pro	PRO	25,000	500	2,000	+ AI Insights (10/day), Bulk (10 scenarios), Compliance Reports (50/mo)
Business	ULTRA	100,000	500	2,000	+ Organizations, AI Insights (50/day), Bulk (25), Compliance (200/mo)
Enterprise	MEGA	500,000	Unlimited	Unlimited	+ Unlimited AI, Bulk (50), All Frameworks, Priority Support

Endpoint Access by Tier

Endpoint	Method	Free	Starter	Pro	Business	Enterprise
/cascade-simulate	POST	✅	✅	✅	✅	✅
/cascade-analyze	POST	✅	✅	✅	✅	✅
/cascade-sector-template	GET	✅	✅	✅	✅	✅
/cascade-schema	GET	✅	✅	✅	✅	✅
/health	GET	✅	✅	✅	✅	✅
/cascade-recover	POST	❌	✅	✅	✅	✅
/cascade-topology-score	POST	❌	✅	✅	✅	✅
/cascade-compare	POST	❌	✅	✅	✅	✅
/cascade-whatif	POST	❌	✅	✅	✅	✅
/cascade-profiles	CRUD	❌	✅	✅	✅	✅
/cascade-webhooks	CRUD	❌	✅	✅	✅	✅
/cascade-audit-log	GET	❌	✅	✅	✅	✅
/cascade-bulk	POST	❌	❌	✅	✅	✅
/cascade-insights	POST	❌	❌	✅	✅	✅
/cascade-compliance-report	POST	❌	✅	✅	✅	✅
/cascade-org	CRUD	❌	❌	❌	✅	✅

Authentication

All requests are authenticated via RapidAPI. Include these headers with every request:

X-RapidAPI-Key: YOUR_RAPIDAPI_KEY
X-RapidAPI-Host: cascadeguard.p.rapidapi.com

Endpoint Examples

1. Cascade Simulation (Free+)

POST /cascade-simulate

Run a cascade failure simulation with deterministic propagation.

curl -X POST "https://cascadeguard.p.rapidapi.com/cascade-simulate" \
  -H "X-RapidAPI-Key: YOUR_KEY" \
  -H "X-RapidAPI-Host: cascadeguard.p.rapidapi.com" \
  -H "Content-Type: application/json" \
  -d '{
    "initialFailures": ["power-grid-001"],
    "assets": [
      {
        "asset_id": "power-grid-001",
        "name": "Regional Power Grid",
        "asset_type": "power",
        "criticality_score": 0.95,
        "redundancy_level": "partial",
        "recovery_time_hours": 24
      },
      {
        "asset_id": "water-plant-001",
        "name": "Water Treatment Plant",
        "asset_type": "water",
        "criticality_score": 0.85,
        "redundancy_level": "none",
        "recovery_time_hours": 12
      }
    ],
    "dependencies": [
      {
        "source_id": "power-grid-001",
        "target_id": "water-plant-001",
        "dependency_type": "critical"
      }
    ],
    "scenario": {
      "failureType": "physical",
      "timeHorizonHours": 48
    }
  }'

2. Vulnerability Analysis (Free+)

POST /cascade-analyze

Identify single points of failure, cascade potential, and redundancy gaps.

curl -X POST "https://cascadeguard.p.rapidapi.com/cascade-analyze" \
  -H "X-RapidAPI-Key: YOUR_KEY" \
  -H "X-RapidAPI-Host: cascadeguard.p.rapidapi.com" \
  -H "Content-Type: application/json" \
  -d '{
    "assets": [
      {
        "asset_id": "power-grid-001",
        "name": "Regional Power Grid",
        "asset_type": "power",
        "criticality_score": 0.95,
        "redundancy_level": "none",
        "recovery_time_hours": 24
      },
      {
        "asset_id": "data-center-001",
        "name": "Primary Data Center",
        "asset_type": "data",
        "criticality_score": 0.9,
        "redundancy_level": "partial",
        "recovery_time_hours": 8
      }
    ],
    "dependencies": [
      {
        "source_id": "power-grid-001",
        "target_id": "data-center-001",
        "dependency_type": "critical"
      }
    ],
    "analysisOptions": {
      "includeSPOF": true,
      "includeCascadePotential": true,
      "includeRedundancyGaps": true
    }
  }'

3. Sector Templates (Free+)

GET /cascade-sector-template

Retrieve industry-specific asset configurations.

curl -X GET "https://cascadeguard.p.rapidapi.com/cascade-sector-template?sector=power" \
  -H "X-RapidAPI-Key: YOUR_KEY" \
  -H "X-RapidAPI-Host: cascadeguard.p.rapidapi.com"

Available sectors: power, water, telecom, transport, healthcare, finance, manufacturing, government

4. Recovery Planning (Starter+)

POST /cascade-recover

Generate optimal recovery timeline with resource allocation.

curl -X POST "https://cascadeguard.p.rapidapi.com/cascade-recover" \
  -H "X-RapidAPI-Key: YOUR_KEY" \
  -H "X-RapidAPI-Host: cascadeguard.p.rapidapi.com" \
  -H "Content-Type: application/json" \
  -d '{
    "failedAssetIds": ["power-grid-001", "water-plant-001"],
    "assets": [
      {
        "asset_id": "power-grid-001",
        "name": "Regional Power Grid",
        "asset_type": "power",
        "criticality_score": 0.95,
        "redundancy_level": "partial",
        "recovery_time_hours": 24
      },
      {
        "asset_id": "water-plant-001",
        "name": "Water Treatment Plant",
        "asset_type": "water",
        "criticality_score": 0.85,
        "redundancy_level": "none",
        "recovery_time_hours": 12
      }
    ],
    "dependencies": [
      {
        "source_id": "power-grid-001",
        "target_id": "water-plant-001",
        "dependency_type": "critical"
      }
    ],
    "constraints": {
      "maxBudget": 500000,
      "maxTimeHours": 168
    }
  }'

5. Topology Score (Starter+)

POST /cascade-topology-score

Analyze infrastructure resilience with A-F grading.

curl -X POST "https://cascadeguard.p.rapidapi.com/cascade-topology-score" \
  -H "X-RapidAPI-Key: YOUR_KEY" \
  -H "X-RapidAPI-Host: cascadeguard.p.rapidapi.com" \
  -H "Content-Type: application/json" \
  -d '{
    "assets": [
      {
        "asset_id": "power-grid-001",
        "name": "Regional Power Grid",
        "asset_type": "power",
        "criticality_score": 0.95,
        "redundancy_level": "partial",
        "recovery_time_hours": 24
      },
      {
        "asset_id": "water-plant-001",
        "name": "Water Treatment Plant",
        "asset_type": "water",
        "criticality_score": 0.85,
        "redundancy_level": "none",
        "recovery_time_hours": 12
      }
    ],
    "dependencies": [
      {
        "source_id": "power-grid-001",
        "target_id": "water-plant-001",
        "dependency_type": "critical"
      }
    ]
  }'

6. Compare Configurations (Starter+)

POST /cascade-compare

Compare baseline vs proposed infrastructure changes.

curl -X POST "https://cascadeguard.p.rapidapi.com/cascade-compare" \
  -H "X-RapidAPI-Key: YOUR_KEY" \
  -H "X-RapidAPI-Host: cascadeguard.p.rapidapi.com" \
  -H "Content-Type: application/json" \
  -d '{
    "baseline": {
      "assets": [
        {
          "asset_id": "power-001",
          "name": "Power Grid",
          "asset_type": "power",
          "criticality_score": 0.9,
          "redundancy_level": "none",
          "recovery_time_hours": 24
        }
      ],
      "dependencies": []
    },
    "proposed": {
      "assets": [
        {
          "asset_id": "power-001",
          "name": "Power Grid",
          "asset_type": "power",
          "criticality_score": 0.9,
          "redundancy_level": "full",
          "recovery_time_hours": 12
        }
      ],
      "dependencies": []
    }
  }'

7. What-If Analysis (Starter+)

POST /cascade-whatif

Test hypothetical infrastructure modifications.

curl -X POST "https://cascadeguard.p.rapidapi.com/cascade-whatif" \
  -H "X-RapidAPI-Key: YOUR_KEY" \
  -H "X-RapidAPI-Host: cascadeguard.p.rapidapi.com" \
  -H "Content-Type: application/json" \
  -d '{
    "currentState": {
      "assets": [
        {
          "asset_id": "power-001",
          "name": "Power Grid",
          "asset_type": "power",
          "criticality_score": 0.9,
          "redundancy_level": "none",
          "recovery_time_hours": 24
        }
      ],
      "dependencies": []
    },
    "modifications": [
      {
        "type": "update_asset",
        "target": "power-001",
        "changes": {
          "redundancy_level": "full"
        }
      }
    ]
  }'

8. Compliance Report (Starter+)

POST /cascade-compliance-report

Generate regulatory compliance assessment.

curl -X POST "https://cascadeguard.p.rapidapi.com/cascade-compliance-report" \
  -H "X-RapidAPI-Key: YOUR_KEY" \
  -H "X-RapidAPI-Host: cascadeguard.p.rapidapi.com" \
  -H "Content-Type: application/json" \
  -d '{
    "assets": [
      {
        "asset_id": "power-grid-001",
        "name": "Regional Power Grid",
        "asset_type": "power",
        "criticality_score": 0.95,
        "redundancy_level": "partial",
        "recovery_time_hours": 24
      }
    ],
    "dependencies": [],
    "framework": "NERC_CIP"
  }'

Frameworks: NERC_CIP, NIST_CSF, ISO_27001, IEC_62443, CISA

9. Infrastructure Profiles (Starter+)

GET/POST /cascade-profiles

Save and retrieve infrastructure configurations.

# List profiles
curl -X GET "https://cascadeguard.p.rapidapi.com/cascade-profiles" \
  -H "X-RapidAPI-Key: YOUR_KEY" \
  -H "X-RapidAPI-Host: cascadeguard.p.rapidapi.com"

# Create profile
curl -X POST "https://cascadeguard.p.rapidapi.com/cascade-profiles" \
  -H "X-RapidAPI-Key: YOUR_KEY" \
  -H "X-RapidAPI-Host: cascadeguard.p.rapidapi.com" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "East Coast Grid",
    "description": "Primary power distribution network",
    "assets": [...],
    "dependencies": [...]
  }'

10. Webhooks (Starter+)

GET/POST/DELETE /cascade-webhooks

Configure event notifications.

# List webhooks
curl -X GET "https://cascadeguard.p.rapidapi.com/cascade-webhooks" \
  -H "X-RapidAPI-Key: YOUR_KEY" \
  -H "X-RapidAPI-Host: cascadeguard.p.rapidapi.com"

# Create webhook
curl -X POST "https://cascadeguard.p.rapidapi.com/cascade-webhooks" \
  -H "X-RapidAPI-Key: YOUR_KEY" \
  -H "X-RapidAPI-Host: cascadeguard.p.rapidapi.com" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-server.com/webhook",
    "events": ["simulation.completed", "simulation.critical"],
    "secret": "your-webhook-secret"
  }'

11. Audit Logs (Starter+)

GET /cascade-audit-log

Retrieve API operation history.

curl -X GET "https://cascadeguard.p.rapidapi.com/cascade-audit-log?limit=50" \
  -H "X-RapidAPI-Key: YOUR_KEY" \
  -H "X-RapidAPI-Host: cascadeguard.p.rapidapi.com"

12. Bulk Simulation (Pro+)

POST /cascade-bulk

Run multiple simulations in a single request (up to 25 scenarios).

curl -X POST "https://cascadeguard.p.rapidapi.com/cascade-bulk" \
  -H "X-RapidAPI-Key: YOUR_KEY" \
  -H "X-RapidAPI-Host: cascadeguard.p.rapidapi.com" \
  -H "Content-Type: application/json" \
  -d '{
    "scenarios": [
      {
        "scenarioId": "scenario-physical",
        "input": {
          "initialFailures": ["power-grid-001"],
          "assets": [...],
          "dependencies": [...],
          "scenario": {"failureType": "physical", "timeHorizonHours": 48}
        }
      },
      {
        "scenarioId": "scenario-cyber",
        "input": {
          "initialFailures": ["data-center-001"],
          "assets": [...],
          "dependencies": [...],
          "scenario": {"failureType": "cyber", "timeHorizonHours": 24}
        }
      }
    ]
  }'

13. AI Insights (Pro+)

POST /cascade-insights

Generate AI-powered natural language analysis.

curl -X POST "https://cascadeguard.p.rapidapi.com/cascade-insights" \
  -H "X-RapidAPI-Key: YOUR_KEY" \
  -H "X-RapidAPI-Host: cascadeguard.p.rapidapi.com" \
  -H "Content-Type: application/json" \
  -d '{
    "simulationResult": {
      "overallImpactScore": 0.75,
      "impactLevel": "HIGH",
      "affectedAssetsCount": 12,
      "cascadeDepth": 4
    },
    "depth": "analyst"
  }'

Depth options: executive (summary), analyst (detailed), engineer (technical)

14. Organizations (Business+)

GET/POST /cascade-org

Team collaboration and organization management.

# List organizations
curl -X GET "https://cascadeguard.p.rapidapi.com/cascade-org" \
  -H "X-RapidAPI-Key: YOUR_KEY" \
  -H "X-RapidAPI-Host: cascadeguard.p.rapidapi.com"

# Create organization
curl -X POST "https://cascadeguard.p.rapidapi.com/cascade-org" \
  -H "X-RapidAPI-Key: YOUR_KEY" \
  -H "X-RapidAPI-Host: cascadeguard.p.rapidapi.com" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Energy Corp Security Team",
    "description": "Infrastructure security analysts"
  }'

15. Schema (Free, No Auth)

GET /cascade-schema

Retrieve API schema and engine capabilities.

curl -X GET "https://cascadeguard.p.rapidapi.com/cascade-schema" \
  -H "X-RapidAPI-Key: YOUR_KEY" \
  -H "X-RapidAPI-Host: cascadeguard.p.rapidapi.com"

16. Health Check (Free, No Auth)

GET /health

Service status and uptime.

curl -X GET "https://cascadeguard.p.rapidapi.com/health" \
  -H "X-RapidAPI-Key: YOUR_KEY" \
  -H "X-RapidAPI-Host: cascadeguard.p.rapidapi.com"

Data Types Reference

Asset Object

Field	Type	Required	Description
asset_id	string	Yes	Unique identifier (max 100 chars)
name	string	Yes	Human-readable name (max 200 chars)
asset_type	enum	Yes	power, water, telecom, transport, data, fuel, defense
criticality_score	number	Yes	Importance: 0.0 - 1.0
redundancy_level	enum	Yes	none, partial, full
recovery_time_hours	number	Yes	Estimated recovery time
region	string	No	Geographic region
zone	string	No	Zone within region
owner_type	enum	No	public, private, military

Dependency Object

Field	Type	Required	Description
source_id	string	Yes	ID of asset being depended upon
target_id	string	Yes	ID of dependent asset
dependency_type	enum	Yes	critical, standard, optional
propagation_delay_hours	number	No	Hours before failure propagates
failure_probability	number	No	Probability: 0.0 - 1.0

Scenario Object

Field	Type	Required	Description
failureType	enum	Yes	physical, cyber, natural, combined
timeHorizonHours	number	Yes	Simulation window (max 720)
maxCascadeDepth	number	No	Max propagation depth (default: 10)
includeRecoveryAnalysis	boolean	No	Include recovery timeline

Error Codes

Code	Status	Description
VALIDATION_ERROR	400	Invalid request body or parameters
UNAUTHORIZED	401	Missing or invalid API key
TIER_UPGRADE_REQUIRED	403	Endpoint requires higher tier
NOT_FOUND	404	Resource not found
RATE_LIMITED	429	Too many requests
INTERNAL_ERROR	500	Server error

Rate Limit Headers

Response headers include rate limit information:

X-RateLimit-Requests-Limit: Maximum requests allowed
X-RateLimit-Requests-Remaining: Requests remaining
X-RateLimit-Requests-Reset: Seconds until reset
X-Request-Id: Unique request identifier for support
X-CascadeGuard-Tier: Your current subscription tier

SDKs

Official SDKs available:

TypeScript/JavaScript: npm install @cascadeguard/sdk
Python: pip install cascadeguard
Go: go get github.com/cascadeguard/cascadeguard-go

Support

Email: cascadeguard@protonmail.com

Documentation: https://cascadeguard.lovable.app/docs

API Reference: https://cascadeguard.lovable.app/api-reference