Alpha Tweet Detection

Overview

The Alpha Tweet Detection endpoint identifies high-potential cryptocurrency investment tweets by analyzing content across four key dimensions: sentiment (bullish/bearish direction), alpha (investment insight quality), legitimacy (source reliability), and technical accuracy (correctness of crypto/DeFi claims). Version 2 includes comprehensive 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://deep42.cambrian.network/api/v1/deep42/social-data/alpha-tweet-detection

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

Query Parameters

Parameter	Type	Required	Default	Description
limit	integer	false	20	Number of tweets to analyze (maximum: 100)
token_filter	string	false	-	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. Used as the reference time for price tracking
scoredAtTimestamp	integer	Unix timestamp (seconds) when the tweet was collected and scored by our 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 signal, <=3 = bearish signal, 4-6 = neutral
alpha	number	DeFi alpha investment insight quality. Range 0-10. Measures actionability of the information for investment decisions
legitimacy	number	Source and claim legitimacy. Range 0-10. Assesses whether claims come from verified sources and contain factual references
technicalAccuracy	number	Technical correctness of crypto/DeFi claims. Range 0-10. Evaluates protocol mechanics and smart contract references
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 official sources
scoresReasoning	string	AI-generated explanation of all score assignments, including specific evidence cited and risk factors
tweetUrl	string	Direct URL to the original tweet on X/Twitter
userTrackRecordSignals	integer	Total bullish/bearish signals made by this author across all tokens
userTrackRecordUniqueTokens	integer	Number of distinct token symbols this author has made signals about
userTrackRecordActiveDays	integer	Number of distinct calendar days this author has made at least one signal
userTrackRecordFirstSignalDate	string	ISO date (YYYY-MM-DD) of this author's earliest tracked signal
userTrackRecordLastSignalDate	string	ISO date (YYYY-MM-DD) of this author's most recent tracked signal
userTrackRecordAccuracy24h	number	24-hour directional prediction accuracy as a percentage (0-100)
userTrackRecordAccuracy7d	number	7-day directional prediction accuracy as a percentage (0-100)
userTrackRecordAccuracy30d	number	30-day directional prediction accuracy as a percentage (0-100)
userTrackRecordAvgReturn24h	number	Average directional return percentage over 24 hours
userTrackRecordAvgReturn7d	number	Average directional return percentage over 7 days
userTrackRecordAvgReturn30d	number	Average directional return percentage over 30 days
userTrackRecordBullishSignals	integer	Number of bullish signals (sentiment >=7) made by this author
userTrackRecordBearishSignals	integer	Number of bearish signals (sentiment <=3) made by this author
userTrackRecordAvgSentiment	number	Author's average sentiment score across all signals. Range 0-10
userTrackRecordAvgAlpha	number	Author's average alpha score across all signals. Range 0-10
userTrackRecordPerformanceTier	string	Performance classification: 'topPerformer' = >=70% accuracy, 'proven' = >=60%, 'unproven' = <60%

Examples

1. Get Latest Alpha Tweets

Retrieve the most recent high-alpha cryptocurrency tweets with detailed scoring and track record analysis.

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

Response:

[
  {
    "twitterHandle": "injective",
    "tokenSymbol": "INJ",
    "text": "The Real-Time USDC Mainnet Upgrade proposal is officially live. $INJ is becoming the settlement layer for real-time stablecoin infrastructure and programmable payments at scale. 99.7% of governance participants have already voted YES.\n\nRead about the top developments that happened on Injective this past week 👇️ \n\n🟪 Injective officially released the upgrade proposal to position $INJ at the center of programmable payments and stablecoin infrastructure at scale.\nhttps://t.co/nqn6PmEZIz\n\n🟪 The Injective AI Toolkit now ships with MCP servers, seven modular agent skills, and full compatibility with Claude Code, Cursor, and Codex. Open source and ready to build.\nhttps://t.co/TCIJ0IJekd\n\n🟪 Native $USDC is now live on Injective testnet through @circle's Cross-Chain Transfer Protocol. One canonical USDC that works across both Wasm and EVM environments.\nhttps://t.co/8QNKb3W6wu\n\n🟪 The Injective MCP Server stores private keys locally with AES-256-GCM encryption. AI models only see wallet addresses and transaction hashes. Keys never leave your machine.\nhttps://t.co/WV37fc1cwE\n\n📊 Key Stats\n\n🟪 Over 99.7% of governance participants have voted YES on the USDC upgrade with 3 days remaining until Injective's biggest mainnet upgrade yet.\nhttps://t.co/yOzjo5t70G\n\n🟪 @HelixMarkets recorded $76.2B in cumulative all-time volume.\nhttps://t.co/Tp5d0JYgT5\n\n🌐 Ecosystem News\n\n🟪 @NinjaLabsHQ introduced City Zero, an onchain builder hub where builders and AI agents on Injective collaborate and build lasting ownership.\nhttps://t.co/sfFlc6KcPf\n\n🟪 @chuhanVcrypto represented Injective at the @Bybit_Official Predicts stage, making the case that where AI agents trade matters more than how.\nhttps://t.co/ROOnQX9yGs\n\nMainnet upgrade looks imminent. Lock in. 🥷",
    "createdAtTimestamp": 1775398940,
    "scoredAtTimestamp": 1775664014,
    "retweetCountAtCollection": 45,
    "favoriteCountAtCollection": 220,
    "replyCountAtCollection": 18,
    "quoteCountAtCollection": 4,
    "sentiment": 9,
    "alpha": 9,
    "legitimacy": 7,
    "technicalAccuracy": 8,
    "isRecent": true,
    "isVerifiable": true,
    "scoresReasoning": "The tweet contains legitimate protocol announcements with verifiable elements: governance voting data (99.7% approval) can be checked on-chain, USDC integration via Circle's CCTP is a documented partnership, the AI toolkit with MCP servers (Model Context Protocol) is a real standard, and AES-256-GCM encryption is a legitimate security mechanism. HelixMarkets $76.2B volume is publicly trackable. Links to official sources are provided. Technical claims about Wasm/EVM dual compatibility are consistent with Injective's architecture. However, no independent verification of specific numbers was performed, and the promotional tone suggests this is ecosystem marketing content. The alpha is informational rather than strategic - it describes infrastructure developments rather than actionable yield strategies or risk opportunities. Overall legitimate information presented optimistically.",
    "tweetUrl": "https://x.com/injective/status/2040797189929111799",
    "userTrackRecordSignals": 165,
    "userTrackRecordUniqueTokens": 6,
    "userTrackRecordActiveDays": 87,
    "userTrackRecordFirstSignalDate": "2025-03-02",
    "userTrackRecordLastSignalDate": "2026-03-05",
    "userTrackRecordAccuracy24h": 34.6,
    "userTrackRecordAccuracy7d": 26.8,
    "userTrackRecordAccuracy30d": 70.0,
    "userTrackRecordAvgReturn24h": -1.07,
    "userTrackRecordAvgReturn7d": -4.35,
    "userTrackRecordAvgReturn30d": 7.71,
    "userTrackRecordBullishSignals": 165,
    "userTrackRecordBearishSignals": 0,
    "userTrackRecordAvgSentiment": 8.21,
    "userTrackRecordAvgAlpha": 6.54,
    "userTrackRecordPerformanceTier": "unproven"
  }
  // ... additional rows omitted for brevity
]

This returns the latest high-alpha tweets with comprehensive scoring across sentiment, alpha quality, legitimacy, and technical accuracy dimensions, plus detailed author performance metrics.

2. Filter by Specific Token

Focus on alpha tweets for a specific cryptocurrency to identify token-specific investment signals and sentiment.

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

Response:

[
  {
    "twitterHandle": "example_trader",
    "tokenSymbol": "BTC",
    "text": "Example BTC analysis tweet...",
    "sentiment": 8,
    "alpha": 7,
    "legitimacy": 6,
    "technicalAccuracy": 8,
    "userTrackRecordAccuracy24h": 72.5,
    "userTrackRecordPerformanceTier": "topPerformer"
  }
]

Returns only tweets mentioning the specified token, enabling focused analysis of token-specific alpha and market sentiment from tracked influencers.

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://deep42.cambrian.network/api/v1/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://deep42.cambrian.network/api/v1/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://deep42.cambrian.network/api/v1/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

• /api/v1/deep42/social-data/influencer-credibility - Returns cryptocurrency influencers ranked by credibility score, track record, accuracy, and engagement metrics
• /api/v1/deep42/social-data/sentiment-shifts - Identifies tokens with significant sentiment changes that could signal market movements and trading opportunities