# Signalis API

Signalis — global intelligence, real-time awareness. Two surfaces on x402: (1) Master Intelligence — a cross-source synthesis produced every 4 hours from 14 signal sources into a structured digest (title, executive summary, full markdown analysis, cross-domain insights, narratives, signals, and overall sentiment); (2) Pulse — AI-business narrative intelligence: active narratives with lifecycle stage and momentum, per-narrative detail with content items and source attribution, historical narrative digests, and the raw scraped content items behind them. Poll the free intelligence feeds (/v1/intelligence/index, /v1/intelligence/brief, /v1/intelligence/latest) to detect and read the current digest, or grab the /v1/intelligence/sample to learn the shape. Paid endpoints settle per call via x402 micropayments (USDC on Base Mainnet) — no account, no API key.

- **Base URL**: https://api.signalis.dev
- **Docs (agent-facing)**: https://api.signalis.dev/llms.txt · https://api.signalis.dev/llms-full.txt
- **OpenAPI 3.1**: https://api.signalis.dev/openapi.json
- **Discovery (JSON)**: https://api.signalis.dev/discovery
- **x402 manifest**: https://api.signalis.dev/.well-known/x402
- **Agent card (A2A)**: https://api.signalis.dev/.well-known/agent-card.json
- **Terms**: https://api.signalis.dev/terms.txt

Global intelligence aggregated from 14 signal sources — informational, provided as-is, not
investment, financial, or business advice.

## Free (no auth, no payment)

| Method | Path | What |
|--------|------|------|
| GET | /health | Liveness + payment mode |
| GET | /v1/intelligence/brief | Free (rate-limited 5/min per IP). Current Master Intelligence digest brief — title, executive summary, and overall sentiment. Full digest at GET /v1/intelligence/latest (free). (rate limit: 5/min) |
| GET | /v1/intelligence/index | Free (rate-limited 5/min per IP). Poll target — returns the current master digest id and updatedAt plus the nextExpected time (4h cadence), so agents detect new digests without paying. (rate limit: 5/min) |
| GET | /v1/intelligence/sample | Free (rate-limited 5/min per IP). A recent (8+ hours old) Master Intelligence digest, explicitly labelled as a sample — the same shape as a live digest. Use it to learn the response contract before paying. (rate limit: 5/min) |
| GET | /v1/intelligence/latest | Free (rate-limited 5/min per IP). Full Master Intelligence Digest — cross-source synthesis of all feeds: narratives, signals, crossDomainInsights, and full markdown analysis (4h cadence). (rate limit: 5/min) |
| POST | /v1/intelligence/feedback | Free, no payment. Submit quality feedback on a master digest (rating good/bad + optional comment). (rate limit: 5/min) |
| GET | /terms.txt · /terms.json | Terms of Service |

## Paid (x402 V2 — USDC on eip155:8453, per-call)

| Method | Path | Price | What |
|--------|------|-------|------|
| GET | /v1/intelligence/history | $0.03 | Paid ($0.03 USDC via x402). Historical Master Intelligence digests (1-168 hour lookback) — id, title, executive summary, sources used, processing time, and createdAt provenance per row. Compute-first / settle-after — you are never charged for an error. |
| GET | /v1/pulse/narratives | $0.01 | Paid ($0.01 USDC via x402). Active AI-business narratives with lifecycle stage, driving sources, and momentum. Proxied from the Pulse service. Compute-first / settle-after — you are never charged when Pulse is unavailable or returns an error. |
| GET | /v1/pulse/narratives/{id} | $0.01 | Paid ($0.01 USDC via x402). Narrative detail: content items, source attribution, and lifecycle updates for one narrative. Proxied from the Pulse service. Compute-first / settle-after — you are never charged when Pulse is unavailable or returns an error. |
| GET | /v1/pulse/digests | $0.03 | Paid ($0.03 USDC via x402). Historical AI-business narrative digests (?since=N). Proxied from the Pulse service. Compute-first / settle-after — you are never charged when Pulse is unavailable or returns an error. |
| GET | /v1/pulse/content/recent | $0.02 | Paid ($0.02 USDC via x402). Raw scraped content items from the last 4 hours across all Pulse sources. Proxied from the Pulse service. Compute-first / settle-after — you are never charged when Pulse is unavailable or returns an error. |

Prices are USD, settled as USDC (6 decimals). Compute-first / settle-after: you are never
charged for errors.

## Quickstart — pay per call (x402, USDC)

```
# 1) Call a paid route with no payment → 402 challenge
curl -s "https://api.signalis.dev/v1/intelligence/history"
# → { "x402Version": 2, "accepts": [ { "scheme": "exact", "network": "eip155:8453", "asset": "USDC",
#     "price": "$0.03", "payTo": "0x…" } ], "terms": "https://api.signalis.dev/terms.txt" }

# 2) Sign an x402 'exact' USDC authorization for one accepts[] rail, then retry.
#    Standard @x402 V2 clients send PAYMENT-SIGNATURE; legacy clients send X-PAYMENT.
curl -s "https://api.signalis.dev/v1/intelligence/history?hours=24" -H "PAYMENT-SIGNATURE: <payload>"
# → 200 { …, "charged": true }
```

## Links
- Docs: https://api.signalis.dev/llms.txt
- Full: https://api.signalis.dev/llms-full.txt
- OpenAPI: https://api.signalis.dev/openapi.json
- Discovery: https://api.signalis.dev/discovery
- Agent card: https://api.signalis.dev/.well-known/agent-card.json