BlackSwan Risk Intelligence
BlackSwan monitors crypto markets 24/7 and produces two risk assessments:
- Flare — Precursor detection from a 15-minute signal window. Use for immediate, alarm-bell risk checks. Before the news breaks.
- Core — State synthesis from a 60-minute signal window. Use for market context and risk assessment. As the news breaks.
When to use each tool
| Question | Tool |
|---|---|
| "Is something happening right now?" | Flare |
| "What's the overall market risk environment?" | Core |
| "Should I be worried about sudden moves?" | Flare |
| "Give me a full risk briefing" | Both (Flare first, then Core) |
Base URL
https://mcp.blackswan.wtf
Endpoints
GET /api/flare
Returns the latest Flare precursor detection assessment.
curl -s https://mcp.blackswan.wtf/api/flare
Response fields:
| Field | Description |
|---|---|
agent | Always "flare" |
data_age | Human-readable age of the data (e.g. "12 minutes ago") |
status | "clear" or "alert" |
severity | "none", "low", "medium", "high", or "critical" |
checked_at | ISO 8601 timestamp of the assessment |
assessment | Natural language risk assessment |
signals | Array of detected signals, each with type, source, and detail |
GET /api/core
Returns the latest Core state synthesis assessment.
curl -s https://mcp.blackswan.wtf/api/core
Response fields:
| Field | Description |
|---|---|
agent | Always "core" |
data_age | Human-readable age of the data (e.g. "1 hour ago") |
timestamp | ISO 8601 timestamp of the assessment |
environment | "stable", "elevated", "stressed", or "crisis" |
assessment | Natural language risk assessment |
key_factors | Array of strings describing the main risk factors |
sources_used | Array of data source names used in the assessment |
data_freshness | Description of how fresh the underlying data is |
Interpreting severity levels (Flare)
| Severity | Meaning |
|---|---|
none | No precursors detected, markets quiet |
low | Minor signals, worth noting but not actionable |
medium | Notable signals, warrants attention |
high | Strong precursors detected, elevated risk of sudden moves |
critical | Extreme signals, immediate risk of major market event |
Interpreting environment levels (Core)
| Environment | Meaning |
|---|---|
stable | Normal market conditions, low systemic risk |
elevated | Above-normal risk, some stress indicators present |
stressed | Significant stress across multiple indicators |
crisis | Severe market stress, active dislocation or contagion |
Error handling
| HTTP Status | Meaning |
|---|---|
200 | Success, response contains full assessment |
502 | Agent output failed validation — format may have changed |
503 | No recent agent runs — system may be starting up |
500 | Unexpected server error |
On non-200 responses, the body is {"error": "..."} with a human-readable message.
Complete risk check pattern
To get a full picture, call both endpoints:
curl -s https://mcp.blackswan.wtf/api/flare
curl -s https://mcp.blackswan.wtf/api/core
Present Flare results first (immediate risks), then Core (broader context).