Cambrian Detect high-alpha tweets API

By Cambrian Network deep42

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

Alpha Tweet Detection

Overview

This endpoint provides a curated feed of cryptocurrency-related tweets that have been algorithmically detected as having high alpha potential for investment decisions. Each tweet is scored across multiple dimensions including sentiment, alpha potential, legitimacy, and technical accuracy, with detailed AI-powered reasoning for each score.

Business Value

  • Alpha Discovery: Identify high-value trading signals and investment insights from social media content before they become mainstream
  • Risk Assessment: Each tweet includes legitimacy and technical accuracy scores to help evaluate the reliability of information
  • Market Sentiment: Track real-time sentiment analysis of cryptocurrency discussions across social platforms
  • Performance Tracking: Access historical track records and accuracy metrics for tweet authors to gauge their prediction reliability
  • Filtering Capabilities: Focus on specific tokens or adjust feed size to match your analysis workflow requirements

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 Primary cryptocurrency token symbol mentioned in the tweet
text string Complete tweet text content
createdAtTimestamp integer Unix timestamp (seconds since epoch) when the tweet was originally posted on Twitter
scoredAtTimestamp integer Unix timestamp (seconds since epoch) when the tweet was collected and scored by our system
retweetCountAtCollection integer Number of retweets at the time of collection (snapshot, not continuously updated)
favoriteCountAtCollection integer Number of likes/favorites at the time of collection (snapshot, not continuously updated)
replyCountAtCollection integer Number of replies at the time of collection (snapshot, not continuously updated)
quoteCountAtCollection integer Number of quote tweets at the time of collection (snapshot, not continuously updated)
sentiment number Sentiment score ranging from 0-10, indicating overall positivity/negativity
alpha number Alpha generation potential score (0-10), measuring the tweet's potential for providing trading insights
legitimacy number Source legitimacy score (0-10), assessing the credibility of the information
technicalAccuracy number Technical accuracy score (0-10), evaluating the correctness of technical claims
isRecent boolean Whether the tweet is considered recent at the time of scoring
isVerifiable boolean Whether the claims in the tweet can be independently verified
scoresReasoning string Detailed AI-powered reasoning explaining the scores and verification assessment
tweetUrl string Direct URL link to the original tweet
userTrackRecordSignals integer Total number of signals/predictions made by this Twitter user
userTrackRecordUniqueTokens integer Number of unique tokens the user has made predictions about
userTrackRecordActiveDays integer Number of days the user has been actively posting predictions
userTrackRecordFirstSignalDate string Date of the user's first recorded signal (YYYY-MM-DD format)
userTrackRecordLastSignalDate string Date of the user's most recent signal (YYYY-MM-DD format)
userTrackRecordAccuracy24h number User's prediction accuracy percentage over the last 24 hours
userTrackRecordAccuracy7d number User's prediction accuracy percentage over the last 7 days
userTrackRecordAccuracy30d number User's prediction accuracy percentage over the last 30 days
userTrackRecordAvgReturn24h number Average return percentage on the user's 24-hour predictions
userTrackRecordAvgReturn7d number Average return percentage on the user's 7-day predictions
userTrackRecordAvgReturn30d number Average return percentage on the user's 30-day predictions
userTrackRecordBullishSignals integer Total number of bullish/positive predictions made by the user
userTrackRecordBearishSignals integer Total number of bearish/negative predictions made by the user
userTrackRecordAvgSentiment number Average sentiment score across all the user's posts
userTrackRecordAvgAlpha number Average alpha score across all the user's posts
userTrackRecordPerformanceTier string Performance classification (e.g., "unproven", "proven", "topPerformer")

Examples

1. Recent High-Alpha Tweets

Get the most recent high-alpha tweets across all cryptocurrencies with default settings.

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

Response:

[
  {
    "twitterHandle": "kazumaxcrypto",
    "tokenSymbol": "SOL",
    "text": "xStocks 🤝 Dreamcash/Hyperliquid 🤝 Boros でエアドロ狙い\n\nロジック🧵：\nxStocksでSpyxを買って、Hyperliquidでショートをし、BorosでマイナスFR支払い勢→FRもらい勢にロックインし、最後にKaminoでSpyを担保にして、ステーブル運用をする。\n\n要は不確定性の高い現在で、Spyxの値動きリスクを取り除いて２〜３箇所のエアドロを同時で狙う戦略！",
    "createdAtTimestamp": 1774606046,
    "scoredAtTimestamp": 1774635696,
    "retweetCountAtCollection": 3,
    "favoriteCountAtCollection": 18,
    "replyCountAtCollection": 1,
    "quoteCountAtCollection": 0,
    "sentiment": 9,
    "alpha": 9,
    "legitimacy": 5,
    "technicalAccuracy": 6,
    "isRecent": false,
    "isVerifiable": true,
    "scoresReasoning": "The tweet describes a complex but technically plausible DeFi strategy involving xStocks (tokenized equities via SPV structure), Hyperliquid's Hip3 Markets (perpetuals), Boros (FR trading), and Kamino (lending). The 10x price differential explanation for Spyx vs S&P500 is conceptually consistent with tokenized asset design. However, significant concerns exist: (1) Boros is an obscure protocol with unverified liquidity; (2) The 1.3% implied APR claim is not cross-verified; (3) Multi-protocol composability increases smart contract risk exponentially; (4) The 'under $10 to hedge $6500 position' claim suggests extreme leverage with liquidation risks; (5) USDG Pendle looping is speculative ('可能性が高く' indicates uncertainty). The strategy involves 4+ protocol interactions, making it high-risk despite technical coherence. Without recent on-chain data on Boros FR markets and xStocks actual airdrop mechanics, this should be treated as unverified alpha rather than confirmed opportunities.",
    "tweetUrl": "https://x.com/kazumaxcrypto/status/2037471548601512191",
    "userTrackRecordSignals": 21,
    "userTrackRecordUniqueTokens": 10,
    "userTrackRecordActiveDays": 17,
    "userTrackRecordFirstSignalDate": "2025-04-10",
    "userTrackRecordLastSignalDate": "2026-02-20",
    "userTrackRecordAccuracy24h": 50.0,
    "userTrackRecordAccuracy7d": 33.3,
    "userTrackRecordAccuracy30d": 100.0,
    "userTrackRecordAvgReturn24h": -1.29,
    "userTrackRecordAvgReturn7d": -4.84,
    "userTrackRecordAvgReturn30d": 24.48,
    "userTrackRecordBullishSignals": 17,
    "userTrackRecordBearishSignals": 4,
    "userTrackRecordAvgSentiment": 7.29,
    "userTrackRecordAvgAlpha": 6.95,
    "userTrackRecordPerformanceTier": "unproven"
  }
  // ... additional rows omitted for brevity
]

The response returns an array of tweet objects, each containing comprehensive scoring metrics and author track records. This example shows a complex DeFi strategy tweet with high alpha (9) and sentiment (9) scores, but moderate legitimacy (5) due to unverified claims about emerging protocols.

2. Bitcoin-Specific Alpha Analysis

Filter for high-alpha tweets specifically discussing Bitcoin opportunities.

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

Response:

[
  {
    "twitterHandle": "adambliv",
    "tokenSymbol": "BTC",
    "text": "The 70/30 STRD/MSTR portfolio absolutely destroys STRK.\n\nYou make close to the same level of fixed income but WAY more growth.\n\nSTRK price = $75.20\nSTRD price = $73.14\nMSTR price = $139.13\nSTRK converts into 0.1 MSTR share per STRK share\nSTRK annual dividend = $8/share\nSTRD annual dividend = $10/share\n\nBitcoin compounds at 25% annually for 10 years\n\nMSTR is 33% amplified Bitcoin, so I model MSTR at 33.25% annual growth",
    "createdAtTimestamp": 1774484511,
    "scoredAtTimestamp": 1774635696,
    "retweetCountAtCollection": 21,
    "favoriteCountAtCollection": 162,
    "replyCountAtCollection": 13,
    "quoteCountAtCollection": 1,
    "sentiment": 9,
    "alpha": 8,
    "legitimacy": 2,
    "technicalAccuracy": 1,
    "isRecent": false,
    "isVerifiable": false,
    "scoresReasoning": "The tweet uses ticker symbols (STRD, MSTR, STRK) that strongly resemble real-world assets (MicroStrategy - MSTR, and potentially Starknet - STRK, and a hypothetical STRD). However, the specific conversion terms (STRK converts into 0.1 MSTR share) and the defined growth rates (33.25% annual growth for MSTR based on 25% Bitcoin compounding) are highly speculative and appear fabricated to support a predetermined conclusion. It lacks any mention of legitimate DeFi mechanisms, yield strategies, or verifiable on-chain data, making it closer to speculative hype than legitimate DeFi alpha.",
    "tweetUrl": "https://x.com/adambliv/status/2036961795999490173",
    "userTrackRecordSignals": 20,
    "userTrackRecordUniqueTokens": 7,
    "userTrackRecordActiveDays": 19,
    "userTrackRecordFirstSignalDate": "2025-03-21",
    "userTrackRecordLastSignalDate": "2026-03-06",
    "userTrackRecordAccuracy24h": 47.1,
    "userTrackRecordAccuracy7d": 40.0,
    "userTrackRecordAccuracy30d": 50.0,
    "userTrackRecordAvgReturn24h": -5.41,
    "userTrackRecordAvgReturn7d": -3.01,
    "userTrackRecordAvgReturn30d": 271.51,
    "userTrackRecordBullishSignals": 18,
    "userTrackRecordBearishSignals": 2,
    "userTrackRecordAvgSentiment": 7.85,
    "userTrackRecordAvgAlpha": 7.25,
    "userTrackRecordPerformanceTier": "unproven"
  }
  // ... additional rows omitted for brevity
]

This filtered response shows Bitcoin-related tweets with varying quality scores. The example demonstrates how the scoring system identifies potentially speculative content (low legitimacy: 2, technical accuracy: 1) despite high sentiment and alpha scores.

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/solana/trending-tokens - Retrieves trending Solana tokens ordered by price change, trade volume, or current price
  • /api/v1/solana/token-pool-search - Find pools containing a specific token with comprehensive trading statistics
  • /api/v1/solana/tokens/security - Provides comprehensive security analysis for Solana tokens including ownership concentration
  • /api/v1/solana/trade-statistics - Get instant trade analytics and performance metrics for SPL tokens with volume breakdowns