# Signalis API — Global intelligence, real-time awareness for AI agents on x402 — the 14-source, 4-hourly Master Intelligence digest plus AI-business Pulse narratives. Per-call, no signup. (v1.0.0)

> Signalis is a pay-per-call global-intelligence API for AI agents. Two surfaces: Master Intelligence (a 14-source, 4-hourly cross-domain synthesis digest) and Pulse (AI-business narrative intelligence — active narratives, narrative detail, historical digests, and raw content). The master-digest feeds are free to poll and read (/v1/intelligence/index, /v1/intelligence/brief, /v1/intelligence/latest) and /v1/intelligence/sample shows the shape; the paid endpoints (master-digest history + the four Pulse routes) settle per call via x402 (USDC on Base). Try /v1/intelligence/latest or /v1/intelligence/sample to learn the shape before paying.

## Base URL
- API: https://api.signalis.dev
- This document: https://api.signalis.dev/llms.txt  ·  Extended: https://api.signalis.dev/llms-full.txt
- Discovery (JSON): https://api.signalis.dev/discovery
- OpenAPI 3.1: https://api.signalis.dev/openapi.json
- 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

## Free endpoints (no auth, no payment)

| Method | Path | Description |
|--------|------|-------------|
| 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) |

## Paid endpoints (x402 V2, USDC on Base, per-call)

| Method | Path | Price | Description |
|--------|------|-------|-------------|
| 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. |

## How to pay (x402)
Each paid call answers a 402 challenge; sign an x402 `exact` USDC authorization for one advertised rail (Base) and retry. Standard @x402 V2 clients send the `PAYMENT-SIGNATURE` header; legacy clients send `X-PAYMENT`. Prices are USD, settled as USDC (6 decimals).

## 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
- Website: https://signalis.dev

## What Signalis covers
Master Intelligence is produced every 4 hours: 14 signal sources (prediction markets, macro/FRED data, crypto, GitHub trends, social/Moltbook chatter, and more) are cross-analyzed by an LLM into a single digest — an executive summary, full markdown analysis, cross-domain insights, the active narratives it detects, discrete signals, and an overall sentiment read. Pulse is the AI-business narrative layer: it clusters scraped content (Reddit, HN, news, and more) into named narratives with a lifecycle stage (emerging / building / peak / fading) and momentum, exposes each narrative's driving content items and source attribution, keeps historical narrative digests, and serves the raw recent content items behind it all.

## Free funnel & honesty
/v1/intelligence/index, /v1/intelligence/brief, and /v1/intelligence/latest are live, rate-limited reads of the current 4-hourly Master Intelligence digest. /v1/intelligence/sample returns a recent (aged) digest, explicitly labelled as a sample, so it is safe for shape-testing without implying it is the freshest data. Every digest carries createdAt provenance and the 4-hour cadence is advertised on /v1/intelligence/index so callers always know how fresh the data is. The Pulse paid routes proxy the standalone Pulse service; you are charged only when Pulse returns data (compute-first / settle-after).