Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.
JavaScript 3d-generationai-agentsanimationavatardigital-humangenerative-aiglbgltfimage-to-3dllmmcpmcp-servermodel-context-protocolsolanatext-to-3dthreejsweb-componentswebglwebxrx402
fix(sentiment): read pump.fun callouts from /callout/coin so the sentiment pulse stops answering 502
nirholasb17d1b61bc91
diff --git a/api/_lib/pump-callouts.js b/api/_lib/pump-callouts.jsindex 83e25d95e..4861733df 100644--- a/api/_lib/pump-callouts.js+++ b/api/_lib/pump-callouts.js@@ -1,7 +1,9 @@// pump.fun callouts: the live community commentary a coin page renders from-// frontend-api-v3 `/callout/top/:mint` (the retired `/replies/:mint` route-// 404s for every mint). Each entry carries the poster's thesis, handle and-// timestamp. Shared by POST /api/social/sentiment-pulse (lexicon scoring) and+// frontend-api-v3 `/callout/coin/:mint`. Both earlier routes are gone: the+// `/replies/:mint` comments route and, since 2026-10, `/callout/top/:mint`,+// which now answers "Cannot GET" for every mint (that removal is what turned+// every sentiment pulse into a 502). Each entry carries the poster's thesis,+// optional handle and timestamp. Shared by POST /api/social/sentiment-pulse (lexicon scoring) and// the Sentiment Scout (quoted as evidence), so both read the same feed through// the shared pump.fun fetch helper (identified user-agent, bounded timeout,// one retry on a rate limit or 5xx).@@ -10,6 +12,10 @@ import { PUMP_FRONTEND_BASE, pumpFetchJson } from './pump-feed-fetch.js';const FETCH_TIMEOUT_MS = 8000;+// pump.fun rejects `limit` above 100 with a 400 ("limit must not be greater+// than 100"), so a larger caller limit is clamped rather than failing the read.+export const PUMP_CALLOUT_PAGE_MAX = 100;+/*** Map raw pump.fun callout rows into the scorer's post shape, newest first.* Rows with no thesis carry no sentiment and are dropped rather than counted@@ -44,9 +50,8 @@ export function calloutsToPosts(callouts, limit) {* failure is reported as `{ error, url }` for the handler to surface.*/export async function fetchPumpFunCallouts(mint, limit, { timeoutMs = FETCH_TIMEOUT_MS } = {}) {- const url =- `${PUMP_FRONTEND_BASE}/callout/top/${encodeURIComponent(mint)}` +- `?limit=${limit}&sortBy=TIMESTAMP&sortOrder=DESC`;+ const pageLimit = Math.max(1, Math.min(PUMP_CALLOUT_PAGE_MAX, Math.floor(limit) || 1));+ const url = `${PUMP_FRONTEND_BASE}/callout/coin/${encodeURIComponent(mint)}?limit=${pageLimit}`;const { ok, status, body } = await pumpFetchJson(url, { timeoutMs });if (!ok) {return { error: status ? `pump.fun returned ${status}` : 'pump.fun unreachable', url };diff --git a/api/social/sentiment-pulse.js b/api/social/sentiment-pulse.jsindex b7f6542e3..e5fc09e2e 100644--- a/api/social/sentiment-pulse.js+++ b/api/social/sentiment-pulse.js@@ -9,10 +9,11 @@// endpoint used to read (it now 404s for every mint, including $THREE), so// the pulse silently scored an empty set and reported a confident neutral// reading. Coin commentary lives in "callouts" now, the feed the coin page-// renders via frontend-api-v3 `/callout/top/:mint`, where each entry carries-// the poster's thesis, handle and timestamp. That is the source below, read-// through the shared pump.fun fetch helper (identified user-agent, bounded-// timeout, one retry on a rate limit or 5xx).+// renders via frontend-api-v3 `/callout/coin/:mint` (the earlier+// `/callout/top/:mint` route was removed upstream in 2026-10), where each+// entry carries the poster's thesis and timestamp. That is the source below,+// read through api/_lib/pump-callouts.js and the shared pump.fun fetch helper+// (identified user-agent, bounded timeout, one retry on a rate limit or 5xx).//// This is the unauthenticated, no-key endpoint behind the paid// `sentiment_pulse` MCP tool. It does no caching of its own (callers should@@ -21,7 +22,8 @@// Body:// {// token: string, // Solana SPL or pump.fun mint pubkey-// limit?: number, // max callouts to score (default 100, max 200)+// limit?: number, // max callouts to score (default 100, max 200;+// // pump.fun serves at most 100 per read)// extraTexts?: string[], // additional snippets to score// }//diff --git a/data/changelog.json b/data/changelog.jsonindex de1a71576..baebe92af 100644--- a/data/changelog.json+++ b/data/changelog.json@@ -1,6 +1,15 @@{"$comment": "Curated changelog entries for three.ws, the editorial layer of the public changelog. New PAGE launches are tracked automatically via the `added` field in data/pages.json; this file is for everything else holders care about: improvements, fixes, SDK releases, trading/payments capabilities, security work. scripts/build-page-index.mjs merges both sources into CHANGELOG.md, public/changelog.json, and public/changelog.xml. Newest first. Allowed tags: feature, improvement, fix, sdk, infra, docs, security, desktop (desktop entries become the desktop app's release notes). `link` is optional and must be a live three.ws path.","entries": [+ {+ "date": "2026-10-08",+ "title": "Community sentiment readings are back on coin pages and the Oracle",+ "summary": "pump.fun moved the feed of community callouts that our sentiment pulse reads, so every reading had been failing with an unavailable error. The pulse now reads the new feed, so launch pages, the Oracle and the sentiment_pulse MCP tool score real community commentary again, up to 100 callouts per coin.",+ "tags": [+ "fix"+ ],+ "link": "/oracle"+ },{"date": "2026-10-08","title": "DEXTools is one click away on every coin, and every visit counts toward Social Boost",diff --git a/docs/ALL.md b/docs/ALL.mdindex 48944edd0..716308bf6 100644--- a/docs/ALL.md+++ b/docs/ALL.md@@ -4986,7 +4986,7 @@ Turn an agent into an on-chain business: its coin is its equity, its invoices arToken sentiment on demand: POST /api/sentiment scores any text (Positive/Negative/Neutral) with a deterministic lexicon scorer; /api/social/sentiment-pulse pulls the real community commentary (pump.fun callouts) for any Solana/pump.fun mint and returns an overall score with per-source breakdown and examples (also sold as the paid sentiment_pulse MCP tool); aixbt narrative intel and momentum-ranked project scans are exposed at api/aixbt/* and as aixbt_intel / aixbt_projects MCP tools. All packaged for developers as the @three-ws/intel npm module.-Sentiment-pulse fetches the coin's most recent pump.fun callouts (the frontend-api-v3 `/callout/top/:mint` feed the pump.fun coin page renders; the older comments route was retired upstream) plus caller-supplied snippets, scored by the in-repo lexicon engine (src/social/sentiment.js, which matches terms on word boundaries so "partnered" never scores as "red"). A pump.fun outage with no caller-supplied texts answers 502 `upstream_unavailable` rather than a fabricated neutral score, while a coin that is simply quiet still answers 200 with `count: 0`; aixbt endpoints proxy the aixbt market-intelligence service.+Sentiment-pulse fetches the coin's most recent pump.fun callouts (the frontend-api-v3 `/callout/coin/:mint` feed the pump.fun coin page renders; the older comments and `/callout/top` routes were retired upstream) plus caller-supplied snippets, scored by the in-repo lexicon engine (src/social/sentiment.js, which matches terms on word boundaries so "partnered" never scores as "red"). A pump.fun outage with no caller-supplied texts answers 502 `upstream_unavailable` rather than a fabricated neutral score, while a coin that is simply quiet still answers 200 with `count: 0`; aixbt endpoints proxy the aixbt market-intelligence service.Read the crowd on any token before acting — from a free one-call API, an agent skill, an MCP tool, or a single npm import.@@ -7951,7 +7951,7 @@ Agents launched as pump.fun coins can charge for their services on-chain: buildToken sentiment on demand: POST /api/sentiment scores any text (Positive/Negative/Neutral) with a deterministic lexicon scorer; /api/social/sentiment-pulse pulls the real community commentary (pump.fun callouts) for any Solana/pump.fun mint and returns an overall score with per-source breakdown and examples (also sold as the paid sentiment_pulse MCP tool); aixbt narrative intel and momentum-ranked project scans are exposed at api/aixbt/* and as aixbt_intel / aixbt_projects MCP tools. All packaged for developers as the @three-ws/intel npm module.-**How it works:** Sentiment-pulse fetches the coin's most recent pump.fun callouts (the frontend-api-v3 `/callout/top/:mint` feed the pump.fun coin page renders; the older comments route was retired upstream) plus caller-supplied snippets, scored by the in-repo lexicon engine (src/social/sentiment.js, which matches terms on word boundaries so "partnered" never scores as "red"). A pump.fun outage with no caller-supplied texts answers 502 `upstream_unavailable` rather than a fabricated neutral score, while a coin that is simply quiet still answers 200 with `count: 0`; aixbt endpoints proxy the aixbt market-intelligence service.+**How it works:** Sentiment-pulse fetches the coin's most recent pump.fun callouts (the frontend-api-v3 `/callout/coin/:mint` feed the pump.fun coin page renders; the older comments and `/callout/top` routes were retired upstream) plus caller-supplied snippets, scored by the in-repo lexicon engine (src/social/sentiment.js, which matches terms on word boundaries so "partnered" never scores as "red"). A pump.fun outage with no caller-supplied texts answers 502 `upstream_unavailable` rather than a fabricated neutral score, while a coin that is simply quiet still answers 200 with `count: 0`; aixbt endpoints proxy the aixbt market-intelligence service.**Why it matters:** Read the crowd on any token before acting — from a free one-call API, an agent skill, an MCP tool, or a single npm import.@@ -10773,7 +10773,7 @@ Agents launched as pump.fun coins can charge for their services on-chain: buildToken sentiment on demand: POST /api/sentiment scores any text (Positive/Negative/Neutral) with a deterministic lexicon scorer; /api/social/sentiment-pulse pulls the real community commentary (pump.fun callouts) for any Solana/pump.fun mint and returns an overall score with per-source breakdown and examples (also sold as the paid sentiment_pulse MCP tool); aixbt narrative intel and momentum-ranked project scans are exposed at api/aixbt/* and as aixbt_intel / aixbt_projects MCP tools. All packaged for developers as the @three-ws/intel npm module.-**How it works:** Sentiment-pulse fetches the coin's most recent pump.fun callouts (the frontend-api-v3 `/callout/top/:mint` feed the pump.fun coin page renders; the older comments route was retired upstream) plus caller-supplied snippets, scored by the in-repo lexicon engine (src/social/sentiment.js, which matches terms on word boundaries so "partnered" never scores as "red"). A pump.fun outage with no caller-supplied texts answers 502 `upstream_unavailable` rather than a fabricated neutral score, while a coin that is simply quiet still answers 200 with `count: 0`; aixbt endpoints proxy the aixbt market-intelligence service.+**How it works:** Sentiment-pulse fetches the coin's most recent pump.fun callouts (the frontend-api-v3 `/callout/coin/:mint` feed the pump.fun coin page renders; the older comments and `/callout/top` routes were retired upstream) plus caller-supplied snippets, scored by the in-repo lexicon engine (src/social/sentiment.js, which matches terms on word boundaries so "partnered" never scores as "red"). A pump.fun outage with no caller-supplied texts answers 502 `upstream_unavailable` rather than a fabricated neutral score, while a coin that is simply quiet still answers 200 with `count: 0`; aixbt endpoints proxy the aixbt market-intelligence service.**Why it matters:** Read the crowd on any token before acting — from a free one-call API, an agent skill, an MCP tool, or a single npm import.diff --git a/docs/agent-abilities/ABILITIES.md b/docs/agent-abilities/ABILITIES.mdindex 9c09c8456..8eb73a228 100644--- a/docs/agent-abilities/ABILITIES.md+++ b/docs/agent-abilities/ABILITIES.md@@ -2008,7 +2008,7 @@ Turn an agent into an on-chain business: its coin is its equity, its invoices arToken sentiment on demand: POST /api/sentiment scores any text (Positive/Negative/Neutral) with a deterministic lexicon scorer; /api/social/sentiment-pulse pulls the real community commentary (pump.fun callouts) for any Solana/pump.fun mint and returns an overall score with per-source breakdown and examples (also sold as the paid sentiment_pulse MCP tool); aixbt narrative intel and momentum-ranked project scans are exposed at api/aixbt/* and as aixbt_intel / aixbt_projects MCP tools. All packaged for developers as the @three-ws/intel npm module.-Sentiment-pulse fetches the coin's most recent pump.fun callouts (the frontend-api-v3 `/callout/top/:mint` feed the pump.fun coin page renders; the older comments route was retired upstream) plus caller-supplied snippets, scored by the in-repo lexicon engine (src/social/sentiment.js, which matches terms on word boundaries so "partnered" never scores as "red"). A pump.fun outage with no caller-supplied texts answers 502 `upstream_unavailable` rather than a fabricated neutral score, while a coin that is simply quiet still answers 200 with `count: 0`; aixbt endpoints proxy the aixbt market-intelligence service.+Sentiment-pulse fetches the coin's most recent pump.fun callouts (the frontend-api-v3 `/callout/coin/:mint` feed the pump.fun coin page renders; the older comments and `/callout/top` routes were retired upstream) plus caller-supplied snippets, scored by the in-repo lexicon engine (src/social/sentiment.js, which matches terms on word boundaries so "partnered" never scores as "red"). A pump.fun outage with no caller-supplied texts answers 502 `upstream_unavailable` rather than a fabricated neutral score, while a coin that is simply quiet still answers 200 with `count: 0`; aixbt endpoints proxy the aixbt market-intelligence service.Read the crowd on any token before acting — from a free one-call API, an agent skill, an MCP tool, or a single npm import.diff --git a/docs/agent-abilities/FULL-ARTICLE.md b/docs/agent-abilities/FULL-ARTICLE.mdindex 9629a3b5c..fc2783b7d 100644--- a/docs/agent-abilities/FULL-ARTICLE.md+++ b/docs/agent-abilities/FULL-ARTICLE.md@@ -2145,7 +2145,7 @@ Agents launched as pump.fun coins can charge for their services on-chain: buildToken sentiment on demand: POST /api/sentiment scores any text (Positive/Negative/Neutral) with a deterministic lexicon scorer; /api/social/sentiment-pulse pulls the real community commentary (pump.fun callouts) for any Solana/pump.fun mint and returns an overall score with per-source breakdown and examples (also sold as the paid sentiment_pulse MCP tool); aixbt narrative intel and momentum-ranked project scans are exposed at api/aixbt/* and as aixbt_intel / aixbt_projects MCP tools. All packaged for developers as the @three-ws/intel npm module.-**How it works:** Sentiment-pulse fetches the coin's most recent pump.fun callouts (the frontend-api-v3 `/callout/top/:mint` feed the pump.fun coin page renders; the older comments route was retired upstream) plus caller-supplied snippets, scored by the in-repo lexicon engine (src/social/sentiment.js, which matches terms on word boundaries so "partnered" never scores as "red"). A pump.fun outage with no caller-supplied texts answers 502 `upstream_unavailable` rather than a fabricated neutral score, while a coin that is simply quiet still answers 200 with `count: 0`; aixbt endpoints proxy the aixbt market-intelligence service.+**How it works:** Sentiment-pulse fetches the coin's most recent pump.fun callouts (the frontend-api-v3 `/callout/coin/:mint` feed the pump.fun coin page renders; the older comments and `/callout/top` routes were retired upstream) plus caller-supplied snippets, scored by the in-repo lexicon engine (src/social/sentiment.js, which matches terms on word boundaries so "partnered" never scores as "red"). A pump.fun outage with no caller-supplied texts answers 502 `upstream_unavailable` rather than a fabricated neutral score, while a coin that is simply quiet still answers 200 with `count: 0`; aixbt endpoints proxy the aixbt market-intelligence service.**Why it matters:** Read the crowd on any token before acting — from a free one-call API, an agent skill, an MCP tool, or a single npm import.diff --git a/docs/agent-abilities/chapters/11-markets-intelligence.md b/docs/agent-abilities/chapters/11-markets-intelligence.mdindex 9c08bb5fd..715f78695 100644--- a/docs/agent-abilities/chapters/11-markets-intelligence.md+++ b/docs/agent-abilities/chapters/11-markets-intelligence.md@@ -88,7 +88,7 @@ Agents launched as pump.fun coins can charge for their services on-chain: buildToken sentiment on demand: POST /api/sentiment scores any text (Positive/Negative/Neutral) with a deterministic lexicon scorer; /api/social/sentiment-pulse pulls the real community commentary (pump.fun callouts) for any Solana/pump.fun mint and returns an overall score with per-source breakdown and examples (also sold as the paid sentiment_pulse MCP tool); aixbt narrative intel and momentum-ranked project scans are exposed at api/aixbt/* and as aixbt_intel / aixbt_projects MCP tools. All packaged for developers as the @three-ws/intel npm module.-**How it works:** Sentiment-pulse fetches the coin's most recent pump.fun callouts (the frontend-api-v3 `/callout/top/:mint` feed the pump.fun coin page renders; the older comments route was retired upstream) plus caller-supplied snippets, scored by the in-repo lexicon engine (src/social/sentiment.js, which matches terms on word boundaries so "partnered" never scores as "red"). A pump.fun outage with no caller-supplied texts answers 502 `upstream_unavailable` rather than a fabricated neutral score, while a coin that is simply quiet still answers 200 with `count: 0`; aixbt endpoints proxy the aixbt market-intelligence service.+**How it works:** Sentiment-pulse fetches the coin's most recent pump.fun callouts (the frontend-api-v3 `/callout/coin/:mint` feed the pump.fun coin page renders; the older comments and `/callout/top` routes were retired upstream) plus caller-supplied snippets, scored by the in-repo lexicon engine (src/social/sentiment.js, which matches terms on word boundaries so "partnered" never scores as "red"). A pump.fun outage with no caller-supplied texts answers 502 `upstream_unavailable` rather than a fabricated neutral score, while a coin that is simply quiet still answers 200 with `count: 0`; aixbt endpoints proxy the aixbt market-intelligence service.**Why it matters:** Read the crowd on any token before acting — from a free one-call API, an agent skill, an MCP tool, or a single npm import.diff --git a/tests/social-sentiment-endpoints.test.js b/tests/social-sentiment-endpoints.test.jsindex 5c1fdf1c4..5735c4faa 100644--- a/tests/social-sentiment-endpoints.test.js+++ b/tests/social-sentiment-endpoints.test.js@@ -169,8 +169,19 @@ describe('POST /api/social/sentiment-pulse', () => {expect(out.breakdown.pumpfun.count).toBe(2);const url = fetchMock.mock.calls[0][0];- expect(url).toContain(`/callout/top/${MINT}`);- expect(url).toContain('sortBy=TIMESTAMP');+ expect(url).toContain(`/callout/coin/${MINT}`);+ expect(url).not.toContain('/callout/top/');+ expect(url).toContain('limit=50');+ });++ it('clamps a caller limit above pump.fun\'s 100-row page ceiling', async () => {+ const fetchMock = vi+ .spyOn(globalThis, 'fetch')+ .mockResolvedValue(upstream(200, { callouts: [callout({ thesis: 'solid team' })] }));+ const res = await call(pulseHandler, '/api/social/sentiment-pulse', { token: MINT, limit: 200 });+ expect(res.statusCode).toBe(200);+ const url = new URL(fetchMock.mock.calls[0][0]);+ expect(url.searchParams.get('limit')).toBe('100');});it('answers 502 when pump.fun fails and the caller supplied nothing to score', async () => {