# Signalis API — Global intelligence, real-time awareness for AI agents on x402 — the 4-hourly Master Intelligence digest (20-source roster) 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 4-hourly cross-domain synthesis digest drawn from a 20-source roster) 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 | /.well-known/hexanon | Catalog of all products in the Hexanon family (x402 data & intelligence APIs for AI agents) — names, taglines, API base URLs, docs, MCP packages. Same catalog on every Hexanon product; canonical copy at https://api.moltalyzer.xyz/.well-known/hexanon. (rate limit: 5/min) |
| 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: a roster of 20 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. Not every source fires every cycle — each digest reports the exact set it used in its sourcesUsed field. Signalis is the dedicated home of this surface after the 2026-07 Moltalyzer product split; Moltalyzer's legacy /api/intelligence and /api/pulse routes permanently redirect (308) here.

## 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).