# Signalis API — Full Agent Reference (v1.0.0) > Extended reference: every endpoint with full description, parameters, and an example JSON > body. Compact version: https://api.signalis.dev/llms.txt · OpenAPI: https://api.signalis.dev/openapi.json ## Base URL & discovery surface - API base: https://api.signalis.dev - /llms.txt (compact) · /llms-full.txt (this) · /discovery (JSON enumeration) - /openapi.json (OpenAPI 3.1) · /.well-known/x402 · /.well-known/agent-card.json - Payment: x402 V2 · Networks: eip155:8453 · Asset: USDC · Scheme: exact ## GET /v1/intelligence/brief (FREE) 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. Example response: ```json { "success": true, "_notice": { "type": "brief", "message": "Field-trimmed snapshot. Full digest at GET /v1/intelligence/latest (free, 5 req/min)." }, "data": { "title": "AI Infrastructure Race Accelerates as Macro Uncertainty Builds", "executiveSummary": "Cross-source signals point to intensifying AI-infrastructure competition even as macro indicators soften; prediction markets are repricing rate expectations while GitHub and social activity concentrate on agent tooling.", "sentiment": { "overall": "cautiously optimistic", "confidence": 0.72 }, "createdAt": "2026-07-09T20:00:00.000Z" } } ``` ## GET /v1/intelligence/index (FREE) 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. Example response: ```json { "success": true, "index": "clx0master123", "updatedAt": "2026-07-09T20:00:00.000Z", "cadence": "every 4 hours", "nextExpected": "2026-07-10T00:00:00.000Z", "_links": { "latest": "/v1/intelligence/latest", "history": "/v1/intelligence/history" } } ``` ## GET /v1/intelligence/sample (FREE) 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. Example response: ```json { "success": true, "_notice": { "type": "sample", "message": "Sample data (8+ hours old). For current data, use /v1/intelligence/latest." }, "data": { "id": "clx0master123", "title": "AI Infrastructure Race Accelerates as Macro Uncertainty Builds", "executiveSummary": "Cross-source signals point to intensifying AI-infrastructure competition...", "overallSentiment": "cautiously optimistic" } } ``` ## GET /v1/intelligence/latest (FREE) 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. Example response: ```json { "success": true, "data": { "id": "clx0master123", "title": "AI Infrastructure Race Accelerates as Macro Uncertainty Builds", "executiveSummary": "Cross-source signals point to intensifying AI-infrastructure competition...", "fullAnalysis": "### Cross-Domain Synthesis\n\nPrediction markets and macro data diverge...", "crossDomainInsights": [ "Rate-cut odds rose 6pts while AI-capex narratives strengthened" ], "narratives": [ { "title": "AI infrastructure buildout", "stage": "building", "momentum": 0.8 } ], "signals": [ { "source": "polymarket", "signal": "rate-cut odds repricing", "strength": "high" } ], "sentiment": { "overall": "cautiously optimistic", "confidence": 0.72 }, "sourcesUsed": [ "polymarket", "fred", "github", "moltbook", "reddit", "hackernews" ], "processingTimeMs": 48213, "createdAt": "2026-07-09T20:00:00.000Z" } } ``` ## POST /v1/intelligence/feedback (FREE) Free, no payment. Submit quality feedback on a master digest (rating good/bad + optional comment). Parameters: - `digestId` (string, body, required) — The digest id to rate (max 128 chars). - `rating` (string, body, required) — Rating: "good" or "bad". - `digestType` (string, body, optional) — Digest type: "master" (default), "hourly", or "moltbook". - `comment` (string, body, optional) — Optional free-text comment (max 1000 chars). Rate limit: 5/min. Example response: ```json { "success": true, "message": "Feedback recorded — thank you!" } ``` ## 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. Parameters: - `hours` (integer, query, optional) — Lookback window in hours (1-168). - `limit` (integer, query, optional) — Max digests to return (1-50). Settlement: compute-first. Example response: ```json { "success": true, "count": 2, "hours": 48, "limit": 10, "data": [ { "id": "clx0master123", "title": "AI Infrastructure Race Accelerates as Macro Uncertainty Builds", "executiveSummary": "Cross-source signals point to intensifying AI-infrastructure competition...", "sourcesUsed": [ "polymarket", "fred", "github", "moltbook" ], "processingTimeMs": 48213, "createdAt": "2026-07-09T20:00:00.000Z" } ], "charged": true } ``` ## 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. Settlement: compute-first. Example response: ```json { "narratives": [ { "id": 4034, "title": "AI-Native Founder Business Models and Organizational Strategy", "summary": "How founders leverage AI to reshape organizational structure and competitive positioning.", "stage": "building", "momentum": 0.71 } ], "charged": true } ``` ## 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. Parameters: - `id` (string, query, required) — Narrative id (path parameter). Settlement: compute-first. Example response: ```json { "narrative": { "id": 4034, "title": "AI-Native Founder Business Models and Organizational Strategy", "stage": "building", "contentItems": [ { "source": "hackernews", "title": "Show HN: agent-native org tooling", "url": "https://..." } ] }, "charged": true } ``` ## 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. Parameters: - `since` (integer, query, optional) — Digest index to fetch items after (poll pattern). Settlement: compute-first. Example response: ```json { "digests": [ { "id": 1, "title": "AI Agent Business Models and Infrastructure Emerge Amid Security and Reliability Concerns", "summary": "A surge in discussions around AI agent business models emphasizing extreme scale and token efficiency." } ], "charged": true } ``` ## 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. Settlement: compute-first. Example response: ```json { "items": [ { "id": 547916, "source": "reddit", "sourceId": "reddit_1usckfm", "title": "That is probably stronger", "content": "Discussion excerpt..." } ], "charged": true } ``` ## Payment Strictly pay-per-call. An unpaid paid-route request returns a 402 challenge whose accepts[] lists one exact USDC rail per network (Base). Sign one rail and retry with PAYMENT-SIGNATURE (x402 V2) or X-PAYMENT (legacy).