Skills blackclaw

Real-time crypto risk intelligence; before and as things break. Two tools: Flare (15-min precursor detection, immediate alarms) and Core (60-min state synthesis, context assessment). Free access to the last analysis. No API key required. Upgrade to x402 for custom analysis.

install
source · Clone the upstream repo
git clone https://github.com/openclaw/skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/bilalmotiwala/blackswan" ~/.claude/skills/openclaw-skills-blackclaw && rm -rf "$T"
OpenClaw · Install into ~/.openclaw/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/bilalmotiwala/blackswan" ~/.openclaw/skills/openclaw-skills-blackclaw && rm -rf "$T"
manifest: skills/bilalmotiwala/blackswan/SKILL.md
source content

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

QuestionTool
"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:

FieldDescription
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:

FieldDescription
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)

SeverityMeaning
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)

EnvironmentMeaning
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 StatusMeaning
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).