Bitcoin social intelligence, built on X/Twitter data

The job

Bitcoin signal is scattered and surfaces first on X — a developer thread, an ETF analyst, a sudden spike in mempool or L2 chatter. Watching it by hand is noisy and context-poor. This radar reads the public data, structures it, and hands you evidence to interpret — not trading advice.

Workflow A · Narrative Radar

One always-on call returns matched tweets and a de-duplicated author set — exactly what an LLM summarizer or RAG pipeline wants, with no client-side join.

GET /v1/search/recent/enriched?query=bitcoin OR $BTC&limit=20
Authorization: Bearer <api_key>

{
  "data": {
    "tweets": [ { "id", "text", "author_id", "quote_count" } … ],
    "authors": [ { "id", "username", "verified", "follower_count" } … ]
  },
  "meta": { "credits": { "charged": 41 }, "pagination": { "next_token": "…" } }
}

Workflow B · Tweet Dossier

Paste a hot BTC tweet id. One call returns the tweet, its author, its quotes, and its retweeters — so you can answer why it is spreading, who is amplifying it, and what the counterpoints are. Go deeper with thread and conversation.

GET /v1/tweets/1234567890/context
Authorization: Bearer <api_key>

{
  "data": {
    "tweet": { … },
    "author": { … },
    "quotes": [ … ],
    "retweeters": [ … ]
  },
  "meta": { "credits": { "charged": 3 } }
}

The full radar

What will it cost?

Estimate credits from your monitoring shape. Numbers compute from current pricing; failed calls, rate limits, and service-side errors are never charged.

Copy-paste starter

A dependency-free TypeScript starter: query enriched search, tally the loudest authors, and print what the call cost. Clone the full template — coming soon.

/**
 * Minimal Bitcoin "Narrative Radar" with xfetch — no dependencies.
 * Run: XFETCH_API_KEY=sk_live_... npx tsx radar.ts
 */
const API = "https://api.xfetch.io";
const KEY = process.env.XFETCH_API_KEY;
const QUERY = 'bitcoin OR $BTC OR "Bitcoin ETF"';

async function main() {
  if (!KEY) throw new Error("Set XFETCH_API_KEY");

  const url = new URL("/v1/search/recent/enriched", API);
  url.searchParams.set("query", QUERY);
  url.searchParams.set("limit", "20");

  const res = await fetch(url, { headers: { Authorization: `Bearer ${KEY}` } });
  if (!res.ok) throw new Error(`xfetch ${res.status}`);
  const body = await res.json();

  const data = body.data ?? { tweets: [], authors: [] };
  const authors = new Map();
  for (const a of data.authors) authors.set(a.id, a);

  const counts = new Map();
  for (const t of data.tweets) counts.set(t.author_id, (counts.get(t.author_id) ?? 0) + 1);

  const ranked = [...counts.entries()]
    .sort((a, b) => b[1] - a[1])
    .slice(0, 5)
    .map(([id, n]) => `${n}x  @${authors.get(id)?.username ?? id}`);

  console.log("Top rising authors:\n" + ranked.join("\n"));
  console.log("\nCredits charged:", body.meta?.credits?.charged);
}

main().catch((e) => { console.error(e); process.exit(1); });

Boundaries

Related workflows

FAQ

Is this a trading or alpha product?

No. xfetch is a read-only data API. This use case structures public X/Twitter data into evidence; it does not give buy/sell signals or investment advice.

Which endpoints does the radar use?

Primarily GET /v1/search/recent/enriched for discovery and GET /v1/tweets/:id/context for drill-down, plus communities, lists, and profile lookups for breadth.

How are KOL updates monitored?

Account monitors are configured in the dashboard and deliver updates to generic webhooks or Discord incoming webhooks. They are included with monthly plans and are not credit-metered.

How much does it cost to run?

It depends on how many topics you track and how often you poll. Use the calculator above; at the default preset it lands around the Growth plan.