> For the complete documentation index, see [llms.txt](https://blackswanwtf.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://blackswanwtf.gitbook.io/docs/agents/core.md).

# Core

As news breaks. Comprehensive real-time risk environment assessment.

Window: 1 hour

Purpose: Real-time risk context

Best for: Whats happening right now?

#### Quick Test

```
curl -s https://mcp.blackswan.wtf/api/core
```

### Response Schema

```
{
  "agent": "core",
  "data_age": "1 hour ago",
  "timestamp": "2026-01-15T12:00:00Z",
  "environment": "stable",
  "assessment": "Market conditions normal. No significant stress indicators.",
  "key_factors": [
    "BTC funding rates neutral",
    "No major liquidation events",
    "Prediction markets stable"
  ],
  "sources_used": ["polymarket", "coinglass", "twitter", "news"],
  "data_freshness": "All sources updated within 30 minutes"
}
```

#### Fields

| Field           | Type   | Description                         |
| --------------- | ------ | ----------------------------------- |
| agent           | string | Always "core"                       |
| data\_age       | string | Human-readable age of the data      |
| timestamp       | string | ISO 8601 timestamp                  |
| environment     | string | Overall risk environment            |
| assessment      | string | Natural language risk assessment    |
| key\_factors    | array  | Main factors driving the assessment |
| sources\_used   | array  | Data sources used                   |
| data\_freshness | string | How fresh the underlying data is    |

#### Environment Levels

| Level    | Meaning                                               |
| -------- | ----------------------------------------------------- |
| stable   | Normal conditions, low systemic risk                  |
| elevated | Above-normal risk, some stress indicators             |
| stressed | Significant stress across multiple indicators         |
| crisis   | Severe market stress, active dislocation or contagion |

### When to Use

* Morning market briefings
* Pre-trade risk assessment
* Portfolio rebalancing decisions
* Periodic health checks

Core provides the "why" behind market conditions. Use alongside Flare for complete coverage.
