Alpha Tweet Detection

Overview

Detect high-alpha tweets with AI-powered scoring across four key dimensions: sentiment direction, investment insight quality, source reliability, and technical accuracy. This endpoint feeds cryptocurrency investors with pre-screened, high-quality tweets that have potential alpha value for investment decisions.

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 (max 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)
combinedScore	number	Aggregated score combining all four dimensions
sentiment	number	AI-scored sentiment direction (0-10). >=7 = bullish, <=3 = bearish, 4-6 = neutral
alpha	number	DeFi alpha investment insight quality (0-10). Higher = more novel, specific, and tradeable insight
legitimacy	number	Source and claim legitimacy (0-10). Assesses verified sources and factual references
technicalAccuracy	number	Technical correctness of crypto/DeFi claims (0-10). Evaluates protocol mechanics and on-chain data accuracy
engagement	number	Total engagement metrics (retweets + likes + replies + quotes) at collection time
contentPreview	string	Truncated preview of the tweet text content
tweetUrl	string	Direct URL to the original tweet on X/Twitter

Examples

1. Get Latest High-Alpha Tweets

This example retrieves the most recent tweets with high alpha potential across all tokens.

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": "cointelegraph",
    "tokenSymbol": "BSOL",
    "combinedScore": 18,
    "sentiment": 9,
    "alpha": 8,
    "legitimacy": 10,
    "technicalAccuracy": 10,
    "engagement": 435,
    "contentPreview": "🔥 UPDATE: Bitwise to launch its Solana Staking ETF ($BSOL) today, marking the first US ETP with 100%...",
    "tweetUrl": "https://x.com/cointelegraph/status/1983051175978004826"
  },
  {
    "twitterHandle": "1910345730814042112",
    "tokenSymbol": "HBAR",
    "combinedScore": 18,
    "sentiment": 9,
    "alpha": 9,
    "legitimacy": 9,
    "technicalAccuracy": 9,
    "engagement": 191,
    "contentPreview": "🚨 BREAKING: $HBAR surges +7.4% to $0.195 - its highest level in months following Nasdaq's official c...",
    "tweetUrl": "https://x.com/i/web/status/1982984645525540941"
  }
]

This returns an array of high-quality tweets with the highest combined alpha scores. Each tweet shows strong bullish sentiment (scores of 9) and high legitimacy/technical accuracy scores, indicating reliable investment signals.

2. Filter by Specific Token

This example filters results to only show tweets about a specific cryptocurrency token.

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

Response:

[
  {
    "twitterHandle": "example_trader",
    "tokenSymbol": "ETH",
    "combinedScore": 16,
    "sentiment": 8,
    "alpha": 7,
    "legitimacy": 9,
    "technicalAccuracy": 8,
    "engagement": 156,
    "contentPreview": "ETH scaling solutions showing massive adoption growth...",
    "tweetUrl": "https://x.com/example_trader/status/1234567890"
  }
]

This filtered query returns only tweets discussing ETH, allowing investors to focus on alpha signals for a specific token of interest.

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.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://x402.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 and track record
• /api/v1/deep42/social-data/sentiment-shifts - Identifies tokens with significant sentiment changes that could signal market movements