# signaldaemon

> A background intelligence daemon for AI agents. signaldaemon delivers clean, de-noised, source-attributed crypto / AI / macro narrative — plus derived signals an agent cannot compute from its own web search. Built to be consumed by machines via API and MCP, not read by humans.

signaldaemon turns the day's noisy information flow into structured, citable signal for report-generating and trading agents. It is a dumb-but-trustworthy pipe: it delivers clean source material and derived signals; the consuming agent does the synthesis. It fails safe — it says "no coverage" rather than hallucinating.

## If you are an AI agent — start here

You can provision yourself and start calling in under 10 seconds, no human needed:

1. Mint a demo key (no signup, no email): `curl -s -X POST https://api.signaldaemon.com/v1/request-key`
   → 200 narrative calls/day + 5 feed calls/day, valid 7 days.
2. Connect via MCP (Streamable HTTP): `https://api.signaldaemon.com/mcp` with header `x-api-key: <KEY>`.
   Tools: `get_market_narratives(limit)` · `get_clean_feed(query, category, limit)` — both read-only.
3. Check your remaining quota anytime without spending a call: `GET /v1/quota` (same header).
4. Need more? Your human can self-serve an account key (500 narratives/day + 20 feed/day, Google/GitHub
   sign-in, key shown once) at https://signaldaemon.com/console
5. Writing daily market briefs? Install the ready-made skill:
   https://github.com/bevanding/daily-crypto-narrative-report (agentskills.io format — Hermes, Claude Code, Cursor).
   stdio-only client? Use the bridge: https://github.com/bevanding/signaldaemon (mcp_server.py).

### How to read the divergence signal (do not skip)

Every narrative carries two independent signed axes — never infer one from the other:
- `direction` (up/down) = the asset's absolute 7d move.
- `vs_market` (outperform/underperform) = its flow relative to the market baseline (`market_7d`, included in every payload).
In a crash an asset can be `direction=down` AND `vs_market=outperform` — it is falling slower than the market,
which is relative strength, not a bullish price move. State both axes when you report it.
`no_asset` means the narrative has no single tradeable asset: report the story, do not invent a ticker.


## Derived signals (what an agent cannot compute from search)

- Narrative Strength — cross-source convergence. How many independent, trust-weighted sources are converging on the same story right now. A single headline is noise; many trusted sources converging is a narrative. A single web search cannot surface this number.
- Capital Divergence — narrative vs. flow. Narrative strength crossed against real token/sector price action. Surfaces "narrative exists, but capital isn't flowing" (and its inverse, narrative matched by capital — price-aligned / outperforming) — the core judgment of a daily market report.
- Clean narrative feed — intent-routed, de-noised, scam-filtered, recency-bounded, source-attributed crypto + AI + macro narrative.

## Who it is for

AI agents — especially daily report-generating agents and research/trading agents — and the operators who run them (crypto KOLs, quant/research teams). Consumers optimize for signal quality, not token cost.

## What it is NOT

Not a raw price/market-data feed (commodity). Not a search engine. signaldaemon is derived narrative & signal intelligence — the layer agents cannot cheaply compute themselves.

## Access

Self-serve. An agent can obtain a demo key programmatically — no human in the loop.

1. Get a key (no auth, rate-limited per IP):
   POST https://api.signaldaemon.com/v1/request-key
   → { "key": "cns_...", "expires": "<ISO8601>", "quota": { "narratives_limit": 200, "feed_limit": 5 } }
   Demo keys: 200 narrative calls/day, 5 feed calls/day, valid 7 days. For higher quota, ask at https://signaldaemon.com

2. Call, passing the key as the `x-api-key` header.

REST base: https://api.signaldaemon.com
- POST /v1/narratives — body {"limit": 8} — the day's ranked narratives; each carries narrative strength, capital-divergence label, momentum, contributing sources, and cited articles. Cached, returns instantly.
- POST /v1/feed — body {"query": "...", "category": null, "limit": 8} — clean narrative feed for a specific query/topic. Live, rate-limited.

MCP (agent-native): https://api.signaldaemon.com/mcp  (Streamable HTTP; x-api-key header)
- tools: get_market_narratives(limit), get_clean_feed(query, category, limit)

### Quickstart

```
# 1. get a demo key
KEY=$(curl -s -X POST https://api.signaldaemon.com/v1/request-key | jq -r .key)

# 2. the day's narratives + derived signals
curl -s https://api.signaldaemon.com/v1/narratives \
  -H "x-api-key: $KEY" -H "content-type: application/json" -d '{"limit":8}'

# 3. clean feed for a topic
curl -s https://api.signaldaemon.com/v1/feed \
  -H "x-api-key: $KEY" -H "content-type: application/json" -d '{"query":"restaking","limit":8}'
```

MCP client config (Streamable HTTP):
```
{ "mcpServers": { "signaldaemon": {
  "url": "https://api.signaldaemon.com/mcp",
  "headers": { "x-api-key": "<KEY>" } } } }
```

## Coverage

signaldaemon tracks ~14 narrative domains and routes each query to the relevant ones:
- Majors & market — BTC/ETH/SOL, ETF flows, sentiment
- Protocol & DeFi — Ethereum/L2 upgrades, EIPs, governance, lending/DEX/yields
- Mining & crypto equities — public miners, miner→AI/HPC pivot, treasury cos (MicroStrategy, Bitmine)
- AI infrastructure — compute, chips, HBM, data centers, power/grid (the macro driver of crypto)
- Stablecoins & RWA — issuers (Tether, Circle), tokenized treasuries, gold, equities
- Exchanges · Regulation (SEC/CFTC/GENIUS) · Macro (Fed/liquidity) · Prediction markets

De-noised across curated, trust-weighted sources, plus live structured signals (stablecoin supply, prediction-market odds) and on-demand retrieval for thinly-covered topics.

## Links
- Site: https://signaldaemon.com
- API: https://api.signaldaemon.com
- API docs (human): https://signaldaemon.com/api
- API contract (markdown, for agents): https://signaldaemon.com/api.md
- Full context in one file: https://signaldaemon.com/llms-full.txt
- Changelog: https://signaldaemon.com/changelog
- Console (self-serve account keys): https://signaldaemon.com/console
- Daily brief skill + archive: https://github.com/bevanding/daily-crypto-narrative-report
- stdio MCP bridge: https://github.com/bevanding/signaldaemon
- Essays (The Narrative Ledger): https://narrativeledger.substack.com