# BlackSwan State Synthesis

> BlackSwan State Synthesis is a paid API for AI agents from x402.blackswan.wtf, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-15).

Synthesizes a unified market state picture from multiple data sources to support risk-aware AI agent decision-making

## Facts

- Endpoint: POST https://x402.blackswan.wtf/smart-agents/core
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blackswan-3ad08743
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VJ670iy2K0q3AyzI5cga0

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability blackswan-3ad08743 -d '<json body>'
```

Example prompt: Can you pull the current synthesized market state from BlackSwan — I need a unified view of conditions across all data sources to understand overall risk before my agent makes any trades.

## When to prefer this

Use this endpoint when an AI agent needs a single, pre-synthesized snapshot of market state drawn from multiple sources, rather than querying each data feed individually. Ideal when you need a holistic risk-aware view of the market without building your own aggregation logic.

## Known failure modes

- Data source unavailability causing incomplete synthesis
- Timeout if underlying data feeds are slow
- Invalid or missing required query parameters returning 400 error
- Payment not processed or insufficient USDC balance causing 402 error
- Rate limiting if too many requests in short window

## How this service works

State Synthesis - Synthesizes market state from multiple data sources

## Output

A synthesized market state object aggregated from multiple data sources, providing a unified view of current market conditions, risk indicators, and relevant signals that an AI agent can use for downstream decision-making.

## Example request

```json
{
 "input": {
  "body": {},
  "type": "http",
  "method": "POST",
  "bodyType": "json"
 }
}
```

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "type": "string",
     "enum": [
      "POST"
     ]
    },
    "bodyType": {
     "type": "string",
     "enum": [
      "json",
      "form-data",
      "text"
     ]
    },
    "body": {
     "type": "object",
     "description": "No input required - send empty object",
     "properties": {}
    }
   },
   "required": [
    "type",
    "bodyType",
    "body",
    "method"
   ],
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "timestamp": {
       "type": "string",
       "format": "date-time",
       "description": "Timestamp of synthesis"
      },
      "environment": {
       "type": "string",
       "enum": [
        "stable",
        "elevated",
        "stressed",
        "crisis"
       ],
       "description": "Current market environment state"
      },
      "assessment": {
       "type": "string",
       "description": "Synthesized market state assessment"
      },
      "key_factors": {
       "type": "array",
       "items": {
        "type": "string"
       },
       "description": "Key factors influencing the assessment"
      },
      "sources_used": {
       "type": "array",
       "items": {
        "type": "string"
       },
       "description": "Data sources consulted"
      },
      "data_freshness": {
       "type": "string",
       "description": "Age of the data used"
      }
     },
     "required": [
      "timestamp",
      "environment",
      "assessment",
      "key_factors",
      "sources_used"
     ]
    }
   },
   "required": [
    "type"
   ]
  }
 },
 "required": [
  "input"
 ]
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "timestamp": "2025-01-11T12:00:00Z",
  "assessment": "Markets operating within normal parameters with moderate volatility",
  "environment": "stable",
  "key_factors": [
   "Low VIX levels",
   "Stable funding rates",
   "Neutral sentiment"
  ],
  "sources_used": [
   "derivatives_data",
   "market_data",
   "social_intelligence"
  ],
  "data_freshness": "real-time"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blackswan-3ad08743/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.blackswan.wtf](https://www.zero.xyz/host/x402.blackswan.wtf/llms.txt)