blackswan

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.