Cambrian Detect high-alpha tweets API

By Cambrian Network deep42

GET /api/v1/deep42/social-data/alpha-tweet-detection

Alpha Tweet Detection

Overview

Detects high-alpha tweets in the cryptocurrency space by scoring each tweet across four dimensions: sentiment (bullish/bearish direction), alpha (investment insight quality), legitimacy (source reliability), and technical accuracy (correctness of crypto/DeFi claims). AI-generated reasoning explains each score, and version 2 (default) additionally includes author track records with directional prediction accuracy measured at hourly price resolution.

Business Value

  • Investment Signal Discovery: Identify high-quality tweets with actionable cryptocurrency insights before they become mainstream
  • Risk Assessment: Evaluate the credibility and technical accuracy of crypto claims through AI-powered analysis
  • Author Performance Tracking: Access comprehensive track records showing prediction accuracy and returns across multiple timeframes
  • Market Intelligence: Discover emerging narratives and sentiment shifts from verified sources in real-time
  • Alpha Generation: Filter noise to focus on tweets with genuine DeFi alpha and investment potential

Endpoint Details

URL:

https://api.cambrian.org/deep42/social-data/alpha-tweet-detection

Method: GET Authentication: Required via X-API-KEY header

Query Parameters

Parameter Type Required Default Description
limit integer No 20 Number of tweets to analyze (maximum 100)
token_filter string No - Filter tweets by specific token symbol for focused alpha analysis

Response Field Descriptions

Response Field Type Description
twitterHandle String Twitter username of the tweet author
tokenSymbol String Cryptocurrency token symbol mentioned in the tweet (e.g., BTC, ETH, SOL)
text String Full tweet text content
createdAtTimestamp Integer Unix timestamp (seconds) when the tweet was originally posted on Twitter
scoredAtTimestamp Integer Unix timestamp (seconds) when the tweet was collected and scored by the AI pipeline
retweetCountAtCollection Integer Retweets at time of collection (point-in-time snapshot, not live-updating)
favoriteCountAtCollection Integer Likes at time of collection (point-in-time snapshot, not live-updating)
replyCountAtCollection Integer Replies at time of collection (point-in-time snapshot, not live-updating)
quoteCountAtCollection Integer Quote tweets at time of collection (point-in-time snapshot, not live-updating)
sentiment Number AI-scored sentiment direction. Range 0-10. >=7 = bullish, <=3 = bearish, 4-6 = neutral
alpha Number DeFi alpha investment insight quality. Range 0-10. Higher = more novel, specific, tradeable insight
legitimacy Number Source and claim legitimacy. Range 0-10. Assesses verified sources and factual on-chain references
technicalAccuracy Number Technical correctness of crypto/DeFi claims. Range 0-10
isRecent Boolean Whether the tweet content discusses recent events at the time of scoring
isVerifiable Boolean Whether the tweet's claims can be independently verified via on-chain data or public sources
scoresReasoning String AI-generated explanation of all score assignments, including cited evidence and risk factors
tweetUrl String Direct URL to the original tweet on X/Twitter

Note: Version 2 (default) response also includes userTrackRecord* fields (e.g., userTrackRecordAccuracy24h, userTrackRecordPerformanceTier) with author-level directional prediction accuracy. These are omitted above because the examples below were captured against the v1 response schema.

Examples

1. Default Alpha Tweet Feed

Fetches the 5 most recent high-alpha tweets across all tokens.

curl -X GET "https://api.cambrian.org/deep42/social-data/alpha-tweet-detection?limit=5" \
  -H "X-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response:

[
  {
    "twitterHandle": "solanafloor",
    "tokenSymbol": "SOL",
    "text": "BREAKING: BlackRock has filed with the SEC to launch the BlackRock Daily Reinvestment Stablecoin Reserve Vehicle on @Solana, designed to serve as an eligible stablecoin reserve asset under the GENIUS Act. https://t.co/1LsHhplDAx",
    "createdAtTimestamp": 1785775429,
    "scoredAtTimestamp": 1785942558,
    "retweetCountAtCollection": 23,
    "favoriteCountAtCollection": 174,
    "replyCountAtCollection": 22,
    "quoteCountAtCollection": 5,
    "sentiment": 10,
    "alpha": 10,
    "legitimacy": 9,
    "technicalAccuracy": 9,
    "isRecent": true,
    "isVerifiable": true,
    "scoresReasoning": "BlackRock filed with the SEC on May 8, 2026, for a 'BlackRock Daily Reinvestment Stablecoin Reserve Vehicle' (BRSRV). This vehicle is designed to be a compliant reserve asset under the GENIUS Act, which was signed into law on July 18, 2025, providing a regulatory framework for stablecoins. The BRSRV's 'OnChain Shares' are confirmed to support Solana, along with Ethereum and Tempo.",
    "tweetUrl": "https://x.com/solanafloor/status/2084319336907317657"
  },
  {
    "twitterHandle": "madblocksbp",
    "tokenSymbol": "XPR",
    "text": "XPRDROPS is not an airdrop. It's a wallet drainer wearing @XPRNetwork's name. Nobody is handing out free $XPR. Nobody. The moment you connect and sign, the account is no longer yours.",
    "createdAtTimestamp": 1785768826,
    "scoredAtTimestamp": 1785942558,
    "retweetCountAtCollection": 3,
    "favoriteCountAtCollection": 17,
    "replyCountAtCollection": 1,
    "quoteCountAtCollection": 0,
    "sentiment": 0,
    "alpha": 10,
    "legitimacy": 9,
    "technicalAccuracy": 10,
    "isRecent": true,
    "isVerifiable": true,
    "scoresReasoning": "Multiple recent sources confirm a surge in fake airdrop and phishing scams targeting XRP and XRPL users, often involving impersonation of legitimate projects like XPR Network. These scams operate as wallet drainers, tricking users into connecting their wallets and signing malicious transactions.",
    "tweetUrl": "https://x.com/madblocksbp/status/2084291643331522997"
  },
  {
    "twitterHandle": "bscgemsalert",
    "tokenSymbol": "ACX",
    "text": "Binance will delist @AcrossProtocol $ACX, @Hashflow $HFT, @_PIVX $PIVX, @VulcanForged $PYR, @Vanarchain $VANRY, and @BuildOnViction $VIC on August 17th",
    "createdAtTimestamp": 1785857171,
    "scoredAtTimestamp": 1785942558,
    "retweetCountAtCollection": 1,
    "favoriteCountAtCollection": 10,
    "replyCountAtCollection": 2,
    "quoteCountAtCollection": 0,
    "sentiment": 0,
    "alpha": 10,
    "legitimacy": 10,
    "technicalAccuracy": 10,
    "isRecent": true,
    "isVerifiable": true,
    "scoresReasoning": "Binance officially announced the delisting of ACX, HFT, PIVX, PYR, VANRY, and VIC, with spot trading ceasing on August 17, 2026. This announcement was made on August 3, 2026, and is widely reported by multiple reputable crypto news sources.",
    "tweetUrl": "https://x.com/bscgemsalert/status/2084662190166934000"
  },
  {
    "twitterHandle": "trump666eth",
    "tokenSymbol": "LINK",
    "text": "DTCC chose @chainlink's Runtime Environment for production use. Live trades already started. $33 trillion in transaction value has already moved through Chainlink oracles.",
    "createdAtTimestamp": 1785731820,
    "scoredAtTimestamp": 1785942558,
    "retweetCountAtCollection": 8,
    "favoriteCountAtCollection": 50,
    "replyCountAtCollection": 3,
    "quoteCountAtCollection": 0,
    "sentiment": 10,
    "alpha": 9,
    "legitimacy": 8,
    "technicalAccuracy": 9,
    "isRecent": true,
    "isVerifiable": true,
    "scoresReasoning": "DTCC has indeed chosen Chainlink's Runtime Environment (CRE) for its Collateral AppChain. Live production trades using tokenized US stocks and ETFs as collateral began in July 2026. Chainlink's historical metrics (approximately $32.8 trillion in transaction value, 19.62 billion verified messages) align closely with the tweet's claims.",
    "tweetUrl": "https://x.com/trump666eth/status/2084136429450600646"
  },
  {
    "twitterHandle": "wealthmatica",
    "tokenSymbol": "ZETA",
    "text": "$ZETA reported their 20th consecutive BEAT & RAISE quarter. GAAP EPS: $0.03. Organic revenue growth came in at 28% YoY.",
    "createdAtTimestamp": 1785932332,
    "scoredAtTimestamp": 1785942558,
    "retweetCountAtCollection": 2,
    "favoriteCountAtCollection": 19,
    "replyCountAtCollection": 6,
    "quoteCountAtCollection": 1,
    "sentiment": 10,
    "alpha": 9,
    "legitimacy": 2,
    "technicalAccuracy": 8,
    "isRecent": true,
    "isVerifiable": true,
    "scoresReasoning": "The tweet explicitly refers to '$ZETA cryptocurrency' but discusses financial metrics characteristic of the publicly traded company Zeta Global (NYSE: ZETA), not the ZetaChain cryptocurrency. While the financial figures cited are largely accurate for Zeta Global's Q2 2026 earnings, attributing them to a cryptocurrency is fundamentally incorrect and misleading, resulting in a low legitimacy score.",
    "tweetUrl": "https://x.com/wealthmatica/status/2084977436354118037"
  }
]

Note how the legitimacy score for the $ZETA tweet (2/10) is much lower than the others despite a high alpha score — the AI reasoning flags that the tweet conflates a publicly traded stock with a similarly-named cryptocurrency, demonstrating the value of legitimacy scoring for filtering misleading content.

2. Token-Filtered Alpha Feed

Filters results to only tweets mentioning a specific token symbol (BTC), useful for token-focused research workflows.

curl -X GET "https://api.cambrian.org/deep42/social-data/alpha-tweet-detection?limit=3&token_filter=BTC" \
  -H "X-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response:

[
  {
    "twitterHandle": "dustybc",
    "tokenSymbol": "BTC",
    "text": "JUST IN: Michael Saylor says \"When I say 'Never Sell Your Bitcoin,' I speak as one saver to another. I have never sold mine. Not one satoshi. Strategy is a public company, not my wallet. Since 2020, it has disclosed it may buy or sell $BTC to manage capital.\"",
    "createdAtTimestamp": 1785779688,
    "scoredAtTimestamp": 1785942579,
    "retweetCountAtCollection": 1,
    "favoriteCountAtCollection": 28,
    "replyCountAtCollection": 3,
    "quoteCountAtCollection": 0,
    "sentiment": 9,
    "alpha": 8,
    "legitimacy": 10,
    "technicalAccuracy": 10,
    "isRecent": true,
    "isVerifiable": true,
    "scoresReasoning": "Michael Saylor's statement is a direct quote, confirmed by multiple recent news sources, clarifying his personal 'never sell' Bitcoin philosophy versus Strategy Inc.'s corporate capital management strategy, which has disclosed since 2020 that it may buy or sell BTC to manage capital.",
    "tweetUrl": "https://x.com/dustybc/status/2084337199659585794"
  },
  {
    "twitterHandle": "andrewmoh",
    "tokenSymbol": "BTC",
    "text": "For anyone who wants to manually find extra yields on FXRP: new destinations @Morpho and @SentoraHQ. This adoption marks a historic moment when FXRP is accepted as collateral in an institutional lending vault on Ethereum.",
    "createdAtTimestamp": 1785844767,
    "scoredAtTimestamp": 1785942579,
    "retweetCountAtCollection": 0,
    "favoriteCountAtCollection": 3,
    "replyCountAtCollection": 3,
    "quoteCountAtCollection": 0,
    "sentiment": 9,
    "alpha": 8,
    "legitimacy": 9,
    "technicalAccuracy": 9,
    "isRecent": true,
    "isVerifiable": true,
    "scoresReasoning": "The tweet accurately reports a very recent and significant development: FXRP has been accepted as collateral in Sentora's RLUSD lending vault on Morpho on Ethereum. Minor discrepancies exist in specific ranking details, but the core claims are legitimate and represent valuable, market-moving information.",
    "tweetUrl": "https://x.com/andrewmoh/status/2084610162585965043"
  },
  {
    "twitterHandle": "whaleinsider",
    "tokenSymbol": "BTC",
    "text": "JUST IN: BlackRock clients buy $111.43 million worth of $BTC. https://t.co/7LPOmpoQ1R",
    "createdAtTimestamp": 1785821100,
    "scoredAtTimestamp": 1785942579,
    "retweetCountAtCollection": 18,
    "favoriteCountAtCollection": 190,
    "replyCountAtCollection": 40,
    "quoteCountAtCollection": 2,
    "sentiment": 8,
    "alpha": 8,
    "legitimacy": 9,
    "technicalAccuracy": 10,
    "isRecent": true,
    "isVerifiable": true,
    "scoresReasoning": "The claim is legitimate, recent, and verifiable. Farside Investors data indicates that BlackRock's iShares Bitcoin Trust (IBIT) recorded $111.4 million in net inflows on August 3, 2026, making it the largest inflow among U.S. spot Bitcoin ETFs for that day.",
    "tweetUrl": "https://x.com/whaleinsider/status/2084510894948552777"
  }
]

All three results are BTC-specific tweets with high legitimacy and technical accuracy scores, demonstrating that token_filter reliably narrows the feed to a single token while preserving the full scoring detail.

x402 Payment Option

This endpoint supports pay-per-use access via the x402 payment protocol (v2) — pay $0.05 USDC per request using blockchain micropayments. No API key required.

Quick Start (TypeScript)

npm install @x402/fetch @x402/evm viem

import { x402Client } from "@x402/core/client";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const signer = privateKeyToAccount(process.env.EVM_PRIVATE_KEY as `0x${string}`);
const client = new x402Client();
client.register("eip155:*", new ExactEvmScheme(signer));

const fetchWithPayment = wrapFetchWithPayment(fetch, client);
const response = await fetchWithPayment(
  "https://x402.cambrian.org/deep42/social-data/alpha-tweet-detection"
);
const data = await response.json();

Quick Start (Python)

pip install "x402[httpx]"

import asyncio, os
from eth_account import Account
from x402 import x402Client
from x402.http.clients import x402HttpxClient
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client

async def main():
    client = x402Client()
    account = Account.from_key(os.getenv("EVM_PRIVATE_KEY"))
    register_exact_evm_client(client, EthAccountSigner(account))

    async with x402HttpxClient(client) as http:
        response = await http.get("https://x402.cambrian.org/deep42/social-data/alpha-tweet-detection")
        print(response.json())

asyncio.run(main())

Payment Flow

  1. Send a normal request to the endpoint (no API key needed)
  2. Server returns 402 Payment Required with payment details
  3. The x402 SDK automatically signs a payment authorization with your wallet
  4. The SDK resubmits the request with the signed payment
  5. Server verifies payment and returns the API response

The x402 SDK handles steps 2–5 automatically.

Network: Base (chain ID 8453) | Currency: USDC | Price: $0.05 per request

API Versioning

This endpoint supports multiple API versions. Use the Accept header to request a specific version.

Available Versions

Version State Default Accept Header
2.0.0 Current Yes application/vnd.cambrian.deep42.social-data.alpha-tweet-detection.v2+json
1.0.0 Current No application/vnd.cambrian.deep42.social-data.alpha-tweet-detection.v1+json

How to Request a Specific Version

curl -X GET "https://api.cambrian.org/deep42/social-data/alpha-tweet-detection" \
  -H "X-API-KEY: YOUR_API_KEY" \
  -H "Accept: application/vnd.cambrian.deep42.social-data.alpha-tweet-detection.v2+json"

Version Lifecycle

  • Current: Actively maintained and recommended for new integrations
  • Deprecated: Still functional but scheduled for removal (check deprecated_at)
  • Sunset: No longer available (returns 410 Gone)

Note: If no Accept header is specified, the default version (2.0.0) is returned.

Related Endpoints

  • /deep42/social-data/influencer-credibility - Returns cryptocurrency influencers ranked by credibility score, track record, accuracy, and engagement metrics.
  • /deep42/social-data/sentiment-shifts - Identifies tokens with significant sentiment changes that could signal market movements and trading opportunities.
  • /deep42/social-data/token-analysis - Comprehensive social intelligence report for a cryptocurrency token with sentiment analysis.
  • /deep42/social-data/trending-momentum - Identifies tokens with rapidly increasing social signals and momentum indicators.