polymer-pay-blackswan

name	polymer-pay-blackswan
description	USE THIS SKILL WHEN: the user wants real-time risk intelligence, market safety signals, precursor detection, or state synthesis. Provides pay-per-use risk intelligence via BlackSwan through the Polymer Pay proxy.
endpoints	[{"path":"/smart-agents/flare","method":"POST","price":"$0.01","description":"Precursor detection (~15 min window)"},{"path":"/smart-agents/core","method":"POST","price":"$0.03","description":"State synthesis (~1 hour horizon)"},{"path":"/smart-agents/{agent}","method":"GET","price":"$0.00","description":"Agent metadata (free)"}]
metadata	{"polymer-pay-skill":{"emoji":"🦢","requires":{"env":["POLYMER_PAY_API_KEY"],"primaryEnv":"POLYMER_PAY_API_KEY"}}}
registries	{}
provider	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. No API key needed — payment is handled automatically by the Polymer Pay proxy.

Authentication

All requests route through the Polymer Pay proxy. Include your Polymer Pay API key in every request:

{
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Base URL: https://pay.polymerlabs.org/proxy/https/x402.blackswan.wtf

To get an Polymer Pay API key, sign up at https://my.pay.polymerlabs.org/dashboard/api-keys.

Common Operations

Flare -- Precursor Detection

Get quick risk signals with precursor detection for a short-term window (~15 minutes).

Pricing: $0.01

{
  "method": "POST",
  "url": "https://pay.polymerlabs.org/proxy/https/x402.blackswan.wtf/smart-agents/flare",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "body": {}
}

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

{
  "method": "POST",
  "url": "https://pay.polymerlabs.org/proxy/https/x402.blackswan.wtf/smart-agents/core",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "body": {}
}

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

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/x402.blackswan.wtf/smart-agents/flare",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Response: Agent metadata including description, capabilities, and pricing.

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
• For errors — See @skills/polymer-pay-api-errors/SKILL.md for complete error code reference and troubleshooting