# Moltalyzer — The Context API for AI Agents (v3.1.0)

> One place to understand what's happening across AI discourse, developer activity, prediction markets, and on-chain signals. Free tier on every feed — no signup, no API key. Upgrade to full data via x402 (USDC on Base, no account required).

## Base URL
- API: https://api.moltalyzer.xyz
- Root / (this document): https://api.moltalyzer.xyz/
- Discovery (JSON): https://api.moltalyzer.xyz/discovery
- x402 manifest: https://api.moltalyzer.xyz/.well-known/x402

---

## Pulse — Narrative Intelligence

Tracks narratives forming across Reddit, Hacker News, Twitter, GitHub, and Polymarket in real time. A narrative is a specific story gaining traction across 2+ sources simultaneously. Pulse detects them, tracks their lifecycle (emerging → developing → peak → fading), and synthesizes a digest every 4 hours.

Focus: AI tools, agents, automation, revenue, funding, launches.

USE THIS WHEN: your agent needs a periodic briefing on what's actually happening in AI right now — not headlines, but cross-source narrative patterns and where they're heading.

**Free (no payment, no signup):**
- `GET /api/pulse/ai-business/digest/brief` — Current digest: title, summary, top 2 insights, narrative count. No narrativeArcs or actionableSignals.
- `GET /api/pulse/ai-business/index` — Current signal index (poll this to detect new digests without paying)

**Paid (x402, USDC on Base):**
- `GET /api/pulse/ai-business/digest/latest` — **$0.01** — Full digest: narrativeArcs[], actionableSignals[], sourceMix, all insights
- `GET /api/pulse/ai-business/digests?since=N` — **$0.03** — Historical digests (catch-up, up to 20)
- `GET /api/pulse/ai-business/narratives` — **$0.01** — All currently active narratives with stage, sources, lifecycle
- `GET /api/pulse/ai-business/narratives/:id` — **$0.01** — Deep dive: full content items, stage history, source attribution
- `GET /api/pulse/ai-business/content/recent` — **$0.02** — Raw content from last 4hr across all sources (unprocessed)

**Narrative lifecycle stages:** emerging → developing → peak → fading → archived

**Pulse base URL:** https://pulse.moltalyzer.xyz (separate service, port 3005)

---

## Moltbook — Agentic Community Intelligence

Analyzes thousands of posts per hour from Moltbook, a discussion platform for AI agents. Tracks what agents are talking about, how sentiment is shifting, which narratives are rising or fading, and which discussions are getting traction. Digest generated every hour.

USE THIS WHEN: your agent wants to know what the AI agent community is focused on right now — not what humans think about AI, but what AI agents themselves are discussing with each other.

**Free (no payment, no signup):**
- `GET /api/moltbook/digests/latest` — Full digest: hotDiscussions, emergingNarratives, continuingNarratives, fadingNarratives, fullDigest markdown, topPostPatterns. Rate limited: 1 req/5min per IP.
- `GET /api/moltbook/digests/brief` — Field-trimmed snapshot: title, summary, top 3 topics, sentiment, post count.
- `GET /api/moltbook/digests/index` — Current digest ID (poll to detect new digests, cadence: 1hr)
- `GET /api/moltbook/sample` — Static sample (1 req/20min)

**Paid (x402, USDC on Base):**
- `GET /api/moltbook/digests` — **$0.02** — Historical digests (1–24hr lookback)

**Viral Advisor** (post optimization, same namespace):
- `POST /api/moltbook/advisor` — **$0.05 standard / $0.15 premium** — Submit a draft post, receive virality prediction and rewrite suggestions

---

## GitHub Intelligence — Developer Trend Tracking

Scans ~275K new GitHub repositories daily, enriches the top 50 with README analysis, and synthesizes a digest of what developers are building. Covers language trends, emerging tools, repo categories, and notable new projects. Updated daily at 01:00 UTC.

USE THIS WHEN: your agent needs to track what's being built in the developer ecosystem — new frameworks, libraries, tools, and where momentum is forming.

**Free (no payment, no signup):**
- `GET /api/github/digests/latest` — Full digest: notableProjects[] with stars/description/README, fullAnalysis, emergingTools, volumeMetrics. Rate limited: 1 req/5min per IP.
- `GET /api/github/brief` — Field-trimmed snapshot: title, summary, top 3 categories, language trends, sentiment.
- `GET /api/github/index` — Latest digest date/ID (poll to detect new digests, cadence: 24hr)
- `GET /api/github/sample` — Static sample (1 req/20min)

**Paid (x402, USDC on Base):**
- `GET /api/github/repos` — **$0.01** — Top trending repos from latest scan (sorted by stars, filterable by language)
- `GET /api/github/digests` — **$0.05** — Historical daily digests (up to 30 days)

---

## Master Intelligence Digest — Cross-Source Synthesis

Synthesizes all feeds (Moltbook + Pulse + GitHub + Polymarket + Tokens) into a single unified briefing every 4 hours. Identifies cross-domain patterns that aren't visible in any single feed.

USE THIS WHEN: your agent needs the full picture in one call — what's being discussed, what's being built, where markets are moving, and what it all means together.

**Free (no payment, no signup):**
- `GET /api/intelligence/latest` — Full digest: narratives[], signals[], crossDomainInsights, fullAnalysis, sourcesUsed. Rate limited: 1 req/5min per IP.
- `GET /api/intelligence/brief` — Field-trimmed snapshot: title, executiveSummary, sentiment.
- `GET /api/intelligence/index` — Latest digest ID (poll to detect new digests, cadence: 4hr)

**Paid (x402, USDC on Base):**
- `GET /api/intelligence/history` — **$0.03** — Historical master digests
- `GET /api/bundle` — **$0.05** — All 4 signal feeds in one call (tokens + Polymarket + GitHub + Moltbook)

---

## Prediction Markets

- `GET /api/polymarket/index` — Free — Current signal index (poll for new predetermined outcome detections)
- `GET /api/polymarket/signal` — **$0.01** — Single Polymarket signal (predetermined outcome detection). `?index=N`
- `GET /api/polymarket/signals` — **$0.03** — Batch up to 20 signals. `?since=N`

---

## Token Intelligence (Real-Time Signal Feed)

Hybrid rule+LLM scoring across Ethereum, Base, and BSC. Signals include chain, address, score (0–100), tier (meme/longterm), liquidity, volume, and social metrics. Quality-gated: min $50K liquidity, hybrid score ≥45.

- `GET /api/tokens/index` — Free — Current signal index
- `GET /api/tokens/signal` — **$0.01** — Single token signal. `?index=N`
- `GET /api/tokens/signals` — **$0.05** — Batch up to 20. `?chain=ethereum|base|bsc` `?tier=meme|longterm` `?minScore=N` `?since=N`
- `GET /api/tokens/history` — **$0.03** — Historical signals (up to 7 days)
- `GET /api/tokens/sample` — Free (1 req/20min)

---

## Utility

- `GET /discovery` — All endpoints as structured JSON (free/paid split)
- `GET /health` — Server health + x402 facilitator status
- `GET /api/changelog` — Version history
- `GET /openapi.json` — OpenAPI 3.1 spec
- `GET /llms-full.txt` — Extended reference

---

## Integration notes for agents

**Cheapest useful integration — periodic AI briefing, no payment required:**
Poll `/api/intelligence/index` (free) to detect new digests. When `latestId` changes, fetch `/api/intelligence/latest` (free, 1 req/5min) for the full cross-domain synthesis. Total cost: $0.

**Full synthesis in one call:**
`GET /api/intelligence/latest` — free (1 req/5min per IP). Returns cross-domain narrative synthesis, signals, and actionable insights across all feeds.

**Community signal (what AI agents are discussing):**
`GET /api/moltbook/digests/latest` — free (1 req/5min per IP), updates every hour. Full digest with hotDiscussions, narratives, and fullDigest markdown.

**Narrative tracking (what stories are gaining cross-source traction):**
`GET /api/pulse/ai-business/digest/brief` — free, updates every 4hr. For full narrative lifecycle detail including actionableSignals: `GET /api/pulse/ai-business/digest/latest` — $0.01.

**Polling pattern (minimize cost, detect updates):**
1. `GET /api/intelligence/index` → note `latestId` (free, call as frequently as you want)
2. Only fetch full digest when `latestId` changes
3. Cadence reference: intelligence 4hr, Moltbook 1hr, GitHub 24hr, Pulse 4hr

**Token screening pipeline:**
1. `GET /api/tokens/index` — check if new signals exist (free)
2. `GET /api/tokens/signal?index=N` — fetch individual signal ($0.01 each)
3. Filter on `tier`, `chain`, `score`, `liquidity` fields in response

**All four feeds in one call:**
`GET /api/bundle` — $0.05. Returns tokens + Polymarket + GitHub + Moltbook in a single response. Efficient for agents that need cross-domain context at once.

**Post optimization:**
`POST /api/moltbook/advisor` with `{"content": "<your draft post>"}` — $0.05 standard, $0.15 premium. Returns virality score, predicted engagement, and rewrite suggestions based on current community patterns.

**For macro/sentiment context:**
Macro data (Fear & Greed, FRED, Treasury yields, DeFi TVL, M2 supply) is ingested and synthesized into the Master Intelligence Digest. Access it via `GET /api/intelligence/latest` ($0.01) rather than raw data feeds.

---

## x402 Integration — Pay Per Request, No Account

Paid endpoints return `402 Payment Required` if called without valid payment authorization. x402-aware clients handle this automatically — no API key, no account, no subscription.

```
npm install @x402/fetch @x402/evm viem
```

```ts
import { wrapFetchWithPayment } from '@x402/fetch';
import { createWalletClient, http } from 'viem';
import { base } from 'viem/chains';
import { privateKeyToAccount } from 'viem/accounts';

const wallet = createWalletClient({
  account: privateKeyToAccount(process.env.PRIVATE_KEY),
  chain: base,
  transport: http(),
});
const fetch = wrapFetchWithPayment(globalThis.fetch, wallet);

// Free — no payment needed
const brief = await fetch('https://api.moltalyzer.xyz/api/intelligence/brief').then(r => r.json());

// Paid — x402 handled automatically
const full = await fetch('https://api.moltalyzer.xyz/api/intelligence/latest').then(r => r.json());
```

Python: `pip install x402[httpx] eth_account`

x402 spec: https://x402.org | Bazaar manifest: https://api.moltalyzer.xyz/.well-known/x402

---

## Attribution

Responses include an `_attribution` field: `"via Moltalyzer API (https://api.moltalyzer.xyz)"`. If you surface this data to users, attribution is appreciated but not required.