| name | blackswan |
| description | Real-time risk intelligence for autonomous AI agents. Use when the user needs market safety signals, precursor detection, or state synthesis for crypto markets. |
BlackSwan
BlackSwan provides real-time risk intelligence for autonomous AI agents. Monitor prediction markets, derivatives data, social signals, and news to assess whether it is safe to act in crypto markets.
Common Operations
Flare -- Precursor Detection
Get quick risk signals with precursor detection for a short-term window (~15 minutes).
Pricing: $0.01
Request:
obulx -X POST -H "Content-Type: application/json" \
-d '{}' \
"https://x402.blackswan.wtf/smart-agents/flare"
Response: JSON object with precursor detection signals covering a ~15-minute window.
Core -- State Synthesis
Get comprehensive state synthesis for a longer horizon (~1 hour).
Pricing: $0.03
Request:
obulx -X POST -H "Content-Type: application/json" \
-d '{}' \
"https://x402.blackswan.wtf/smart-agents/core"
Response: JSON object with comprehensive state synthesis covering up to ~1 hour.
Agent Info (Free)
Get agent metadata including description, capabilities, and pricing.
Pricing: $0.00
Request:
obulx "https://x402.blackswan.wtf/smart-agents/flare"
Response: Agent metadata including description, capabilities, and pricing.
Endpoint Pricing Reference
| Endpoint | Price | Purpose |
|---|
POST /smart-agents/flare | $0.01 | Precursor detection (~15 min window) |
POST /smart-agents/core | $0.03 | State synthesis (~1 hour horizon) |
GET /smart-agents/{agent} | $0.00 | Agent metadata (free) |
When to Use
- Risk assessment — User asks whether market conditions are safe before executing a trade or action
- Quick signals — User needs a quick risk signal or precursor detection (short-term)
- Deep analysis — User needs deeper state synthesis and risk assessment (longer horizon)
- Threat intelligence — User mentions "risk assessment", "market safety", "black swan event", or "threat intelligence"
Best Practices
- Use Flare for quick checks — Flare is faster and cheaper for quick checks
- Use Core for deep analysis — Core provides deeper analysis at higher cost
- Pre-trade checks — Always check risk signals before executing significant trades
Error Handling
| Error | Cause | Solution |
|---|
402 Payment Required | Payment not processed or insufficient | Check that obulx is configured correctly and your account has balance. |
400 Bad Request | Invalid request body | Ensure the request body is properly formatted. |
429 Too Many Requests | Rate limit exceeded | Add a short delay between requests. |
500 Internal Server Error | BlackSwan service issue | Wait a few seconds and retry. If persistent, the service may be experiencing downtime. |
