Cambrian Detect high-alpha tweets API

By Cambrian Network deep42

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

Alpha Tweet Detection

Overview

A feed of tweets flagged for high alpha potential in cryptocurrency investments. Each tweet is scored across four dimensions: sentiment (bullish or bearish direction), alpha (investment insight quality), legitimacy (source reliability), and technical accuracy (correctness of crypto/DeFi claims), along with AI-generated reasoning explaining each score. The default version also includes author track records with directional prediction accuracy measured at hourly price resolution.

Business Value

  • Early signal detection: Surfaces tweets with genuinely actionable investment insight rather than generic noise, so traders can act before a narrative goes mainstream.
  • Source credibility scoring: Legitimacy and technical accuracy scores show whether claims are backed by verifiable, factual on-chain evidence, which cuts exposure to misleading narratives.
  • Author track record: Directional prediction accuracy at 24h, 7d, and 30d resolution lets consumers weight signals by the historical reliability of the author, not just the content of a single tweet.
  • Sentiment-aware filtering: Numeric sentiment scoring separates bullish and bearish signals so downstream systems can build directional trading strategies.
  • Token-scoped research: Optional token filtering lets teams focus alpha detection on a specific asset for due diligence or monitoring.

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 300.
token_filter string No - Filter tweets by specific token symbol for focused alpha analysis.
start_time integer No - Start of a fixed time window, in Unix seconds (inclusive). Applies to the post creation time (createdAtTimestamp). Without end_time, the window ends at the time of the request. Minimum 0. Available from version 2.1.
end_time integer No - End of a fixed time window, in Unix seconds (exclusive). Applies to the post creation time (createdAtTimestamp). Without start_time, the window starts 48 hours before end_time. Minimum 1. Available from version 2.1.

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: the token price at this timestamp (rounded to nearest hour) becomes price_at_signal for track record calculations.
scoredAtTimestamp integer Unix timestamp (seconds) when the post was scored. Later than createdAtTimestamp. Versions before 2.1 return the time of the request.
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. Only bullish/bearish tweets generate price prediction signals for track record tracking.
alpha number DeFi alpha investment insight quality. Range 0-10. Measures actionability of the information for investment decisions. Higher = more novel, specific, and tradeable insight.
legitimacy number Source and claim legitimacy. Range 0-10. Assesses whether claims come from verified sources, contain factual on-chain references, and avoid misleading narratives.
technicalAccuracy number Technical correctness of crypto/DeFi claims. Range 0-10. Evaluates protocol mechanics, yield calculations, smart contract references, and on-chain data accuracy.
isRecent boolean Whether the tweet content discusses recent events at the time of scoring. Nullable.
isVerifiable boolean Whether the tweet's claims can be independently verified via on-chain data, official sources, or public records. Nullable.
scoresReasoning string AI-generated explanation of all score assignments, including specific evidence cited, risk factors identified, and verification status of claims. Nullable.
tweetUrl string Direct URL to the original tweet on X/Twitter.
userTrackRecordSignals integer Total bullish/bearish signals made by this author across all tokens. Only counts tweets with sentiment >=7 (bullish) or <=3 (bearish) that have price data available. Nullable.
userTrackRecordUniqueTokens integer Number of distinct token symbols this author has made signals about. Nullable.
userTrackRecordActiveDays integer Number of distinct calendar days this author has made at least one signal. Nullable.
userTrackRecordFirstSignalDate string ISO date (YYYY-MM-DD) of this author's earliest tracked signal. Nullable.
userTrackRecordLastSignalDate string ISO date (YYYY-MM-DD) of this author's most recent tracked signal. Nullable.
userTrackRecordAccuracy24h number 24-hour directional prediction accuracy as a percentage (0-100). A bullish signal is correct if the token price increased within 24h; bearish if it decreased. Price comparison uses hourly resolution, rounded to the nearest hour from the signal timestamp. Calculated only over signals where 24h price data is available. Nullable.
userTrackRecordAccuracy7d number 7-day directional prediction accuracy as a percentage (0-100). Same methodology as 24h accuracy but comparing the price 7 days after the signal. Nullable.
userTrackRecordAccuracy30d number 30-day directional prediction accuracy as a percentage (0-100). Same methodology as 24h accuracy but comparing the price 30 days after the signal. Sample size may be significantly smaller than total signals for recent authors. Nullable.
userTrackRecordAvgReturn24h number Average directional return percentage over 24 hours. For bullish signals: (price_24h - price_at_signal) / price_at_signal * 100. For bearish signals: the inverse. Positive = author's calls are directionally profitable on average. Nullable.
userTrackRecordAvgReturn7d number Average directional return percentage over 7 days. Same methodology as 24h returns but over a 7-day window. Nullable.
userTrackRecordAvgReturn30d number Average directional return percentage over 30 days. Same methodology as 24h returns but over a 30-day window. Nullable.
userTrackRecordBullishSignals integer Number of bullish signals (sentiment >=7) made by this author. Nullable.
userTrackRecordBearishSignals integer Number of bearish signals (sentiment <=3) made by this author. Nullable.
userTrackRecordAvgSentiment number Author's average sentiment score across all signals. Range 0-10. Nullable.
userTrackRecordAvgAlpha number Author's average alpha score across all signals. Range 0-10. Nullable.
userTrackRecordPerformanceTier string Performance classification based on 24h prediction accuracy. 'topPerformer' = >=70% accuracy, 'proven' = >=60%, 'unproven' = <60%. Null if no accuracy data available. Nullable.

Examples

Fetch the Top 3 Alpha Tweets

This example asks for a small feed of the highest-priority scored tweets, useful for a quick scan of current alpha signals. Result collections are limited to 3 items.

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

Response:

[
  {
    "twitterHandle": "kookcapitalllc",
    "tokenSymbol": "XMR",
    "text": "$xmr is about to go parabolic\n\nthere is absolutely no liquidity anywhere\n\nevery cex book combined holds $7.3m of asks within 2%.....\n\nthats for a $11.35b coin\n\nbinance okx and kraken already delisted it\n\n> new supply is 0.6 $xmr a block\n> 0.84% inflation per year and falling\n\nevery time theres a crypto hack we see xmr supply-shock\n\nthe $106m eu exchange theft was reported swapping into $xmr on nov 1\n\n> price holding over $538 mid-range\n> $xmr/$btc at its highest since jan 2023\n\nif we see a weekly close over $800 its price discovery\n\nthere is no float....... the only option is higher\n\nlong term price is going to $10000 per monero\n\nbelieve me now or believe me later\n\nthere is only one real private money and its $xmr",
    "createdAtTimestamp": 1793651040,
    "scoredAtTimestamp": 1793885308,
    "retweetCountAtCollection": 24,
    "favoriteCountAtCollection": 225,
    "replyCountAtCollection": 51,
    "quoteCountAtCollection": 6,
    "sentiment": 10,
    "alpha": 8,
    "legitimacy": 7,
    "technicalAccuracy": 8,
    "isRecent": true,
    "isVerifiable": true,
    "scoresReasoning": "The tweet contains a mix of accurate, verifiable claims and some speculative or exaggerated statements. Monero's market capitalization is indeed around $11.18B - $11.53B, aligning with the tweet's figure. The claim that Binance, OKX, and Kraken have delisted XMR is largely accurate, with delistings occurring in 2023, 2024, and 2026 across various regions due to regulatory pressures. The block reward of 0.6 XMR per block and a decreasing inflation rate (trending towards 0) are also technically correct due to Monero's tail emission. The tweet's mention of a $106 million EU exchange theft on November 1, 2026, with funds being swapped into XMR, is confirmed by recent reports. The current price of XMR is holding above $538, as stated. Furthermore, Monero's all-time high is around $797-$799, so a close over $800 would indeed represent price discovery. However, the specific figure of '$7.3m of asks within 2%' across all CEX books is not directly verifiable through general search results, and the assertion of 'absolutely no liquidity anywhere' is an exaggeration given the daily trading volumes and availability on other platforms. The long-term price prediction of $10,000 is purely speculative and not verifiable.\n\nSources: [tradingview.com](https://www.tradingview.com/symbols/XMRUSD/) | [coincheckup.com](https://coincheckup.com/coins/monero) | [coingecko.com](https://www.coingecko.com/en/coins/monero) | [kraken.com](https://www.kraken.com/prices/monero) | [ledger.com](https://www.ledger.com/coin/price/monero) | [marketcapof.com](https://marketcapof.com/crypto/monero/) | [gate.com](https://www.gate.com/price/monero-xmr) | [liquidityfinder.com](https://liquidityfinder.com/crypto-data/coins/monero) | [tradingview.com](https://www.tradingview.com/news/u_today:bb434bd4d094b:0-okx-removed-eight-trading-pairs-including-monero-dash-and-others-here-s-reason/) | [tradingview.com](https://www.tradingview.com/news/cryptobriefing:cc305d19c094b:0-kraken-to-delist-monero-in-european-economic-area-due-to-regulatory-pressure/) | [kraken.com](https://support.kraken.com/articles/notice-of-delisting-xmr-canada) | [longbridge.com](https://longbridge.com/en/news/269546904) | [binance.com](https://www.binance.com/en/square/post/26858077087114) | [binance.com](https://www.binance.com/en/square/post/3772794283529) | [cryptonews.com](https://cryptonews.com/news/as-exchanges-delist-monero-ghostswap-keeps-it-swappable-no-kyc/) | [kraken.com](https://kraken.com)",
    "tweetUrl": "https://x.com/kookcapitalllc/status/2117352043136598508",
    "userTrackRecordSignals": 387,
    "userTrackRecordUniqueTokens": 53,
    "userTrackRecordActiveDays": 195,
    "userTrackRecordFirstSignalDate": "2025-03-26",
    "userTrackRecordLastSignalDate": "2026-11-04",
    "userTrackRecordAccuracy24h": 51.7,
    "userTrackRecordAccuracy7d": 55,
    "userTrackRecordAccuracy30d": 58.1,
    "userTrackRecordAvgReturn24h": 0.64,
    "userTrackRecordAvgReturn7d": 1.92,
    "userTrackRecordAvgReturn30d": 3.4,
    "userTrackRecordBullishSignals": 314,
    "userTrackRecordBearishSignals": 73,
    "userTrackRecordAvgSentiment": 6.66,
    "userTrackRecordAvgAlpha": 1.49,
    "userTrackRecordPerformanceTier": "unproven"
  },
  {
    "twitterHandle": "meshclans",
    "tokenSymbol": "KMNO",
    "text": "Kamino Fixed Rates just crossed $75M in active loans, ~six weeks after launch.\n\nThe growth is concentrated in one clear use case: leveraged exposure to tokenized U.S. consumer auto loans.\n\nOn Sept 21, @kamino launched fixed-rate borrowing on Solana w/ Figure and @HastraFi.\n\nThe first product was a Fixed Rate Multiply vault on AUTO, Hastra's yield-bearing token backed by Figure's near-prime auto loans through Democratized Prime.\n\nBorrowers lock in 5.3% for 30 days (later markets sit at 5.75% and 6%) w/ auto-rollover if there's liquidity at maturity.\n\nA known rate for a defined period replaces a variable rate that reprices with utilization every few blocks.\n\nPeople clearly wanted it, and the uptake was fast:\n\n\ud83d\udd38 $10M+ originated in the first 72 hours\n\ud83d\udd38 $40M+ in two weeks\n\ud83d\udd38 $62M+ by late October, now $75M\n\ud83d\udd38 AUTO supplied on Kamino went from roughly $9M to nearly $100M, ~10x\n\ud83d\udd38 The broader AUTO market crossed $170M in deposits, with fixed-rate debt making up most of the borrowing\n\nThat makes it the fastest-growing fixed-rate lending protocol onchain.\n\nMultiply has been the main driver.\n\nUsers deposit AUTO \u2192 borrow wYLDS at the fixed rate \u2192 buy more AUTO, all in one transaction.\n\nSo leverage demand ends up creating new issuance of the underlying tokenized loans.\n\nTo me the ramp above is the strongest proof the product works.\n\nAlmost all onchain lending still runs on open-ended variable rates.\n\nThat model is simple and capital-efficient for crypto-native looping, and fixed rates now serve the cases that need predictable financing costs, esp over weeks or months.\n\nThink about RWA issuers scaling distribution + funds running multi-month strategies + tradfi institutions modelling their cost of capital.\n\nHere's what Fixed Rates adds:\n\n\ud83d\udd38 A rate grid, with different rates and durations as separate reserves\n\ud83d\udd38 Conditional liquidity, so capital keeps earning in variable pools until it's matched to a fixed-rate borrow\n\ud83d\udd38 Effectively the first live onchain yield curve\n\nAnd imo the signal here is real.\n\nBorrowers used the product aggressively once rate certainty was there and the underlying yield supported it\n\nand that's what institutions look for before they get involved.\n\nIf the same pattern shows up in other tokenized credit markets or larger RWA pools, this is the kind of credit infra DeFi has been missing.\n\nOnchain credit may not end up exclusively fixed.\n\nIt now has a working, growing option for the cases where fixed actually matters.",
    "createdAtTimestamp": 1793628516,
    "scoredAtTimestamp": 1793885308,
    "retweetCountAtCollection": 9,
    "favoriteCountAtCollection": 64,
    "replyCountAtCollection": 20,
    "quoteCountAtCollection": 0,
    "sentiment": 9,
    "alpha": 8,
    "legitimacy": 9,
    "technicalAccuracy": 9,
    "isRecent": true,
    "isVerifiable": true,
    "scoresReasoning": "The tweet's claims about Kamino Fixed Rates are highly legitimate and technically accurate. The launch date of September 21, 2026, in partnership with Figure and HastraFi, is consistently reported across multiple sources. The product's focus on leveraged exposure to tokenized U.S. consumer auto loans via the AUTO token and the Multiply vault mechanism is well-documented. The initial borrowing rate of 5.3% for 30 days, with later markets at 5.75% and 6%, and auto-rollover, is also confirmed.\n\nAll stated growth metrics are largely verifiable: $10M+ in the first 72 hours, $40M+ in two weeks, $62M+ by late October, and the recent milestone of crossing $75M in active loans. The increase in AUTO supplied on Kamino from ~$9M to ~$100M (~10x) and the broader AUTO market crossing $170M in deposits are also supported by recent reports. The claim that leverage demand creates new issuance of underlying tokenized loans is a logical consequence of the Multiply mechanism and the nature of the AUTO token. While definitively proving it's the 'fastest-growing fixed-rate lending protocol onchain' would require a broader market analysis, the rapid growth and Kamino's position as a leading RWA platform on Solana are strongly indicated. The tweet provides valuable, recent market-moving information about a rapidly expanding DeFi product in the real-world asset sector.\n\nSources: [solanacompass.com](https://solanacompass.com/news/kamino-finance-launches-fixed-rate-multiply-vault-on-solana-with-53-locked-borrow-rate) | [kamino.finance](https://gov.kamino.finance/t/kamino-lend-monthly-risk-insights-september-2026/893) | [solanacompass.com](https://solanacompass.com/news/kamino-says-its-auto-market-passed-170m-a-month-after-fixed-rate-borrowing-launched) | [businesswire.com](https://www.businesswire.com/news/home/20261020423734/en/Kamino-Launches-Fixed-Rate-Borrowing-for-Tokenized-Assets-AUTO-Market-Grows-From-%2410M-to-%24135M-in-Three-Weeks) | [morningstar.com](https://www.morningstar.com/news/business-wire/20261020423734/kamino-launches-fixed-rate-borrowing-for-tokenized-assets-auto-market-grows-from-10m-to-135m-in-three-weeks) | [solanacompass.com](https://solanacompass.com/projects/kamino-finance) | [marketchameleon.com](https://marketchameleon.com/articles/b/2026/10/20/fwdi-kamino-fixed-rate-borrowing-auto-market-growth) | [hastra.io](https://help.hastra.io/auto/what-is-auto) | [kamino.com](https://kamino.com/borrow?search=Main%20Market&filterWalletAssets=false) | [kamino.com](https://kamino.com/assets/auto) | [kamino.com](https://kamino.com/blog/kamino-tokenized-u-s-auto-loans-on-solana) | [kamino.com](https://kamino.com/docs/products/multiply) | [kamino.com](https://kamino.com)",
    "tweetUrl": "https://x.com/meshclans/status/2117257570465276352",
    "userTrackRecordSignals": 24,
    "userTrackRecordUniqueTokens": 18,
    "userTrackRecordActiveDays": 23,
    "userTrackRecordFirstSignalDate": "2025-07-06",
    "userTrackRecordLastSignalDate": "2026-11-02",
    "userTrackRecordAccuracy24h": 54.2,
    "userTrackRecordAccuracy7d": 31.8,
    "userTrackRecordAccuracy30d": 57.1,
    "userTrackRecordAvgReturn24h": 1.42,
    "userTrackRecordAvgReturn7d": -0.81,
    "userTrackRecordAvgReturn30d": -5.24,
    "userTrackRecordBullishSignals": 24,
    "userTrackRecordBearishSignals": 0,
    "userTrackRecordAvgSentiment": 8.25,
    "userTrackRecordAvgAlpha": 6.38,
    "userTrackRecordPerformanceTier": "unproven"
  },
  {
    "twitterHandle": "schwifftynhere",
    "tokenSymbol": "TX",
    "text": "NFA/DYOR \n\nI just pulled the raw on-chain config across all four $USTX Staking smart contracts (CodeID #4023 & #4024) on @txEcosystem Testnet\u2014and it reveals one of the smartest institutional flywheels in crypto.\n\nHere is what is hardcoded directly into the contracts:\n\u2022 Stake Asset: $USTX (@brale_xyz regulated USD stablecoin)\n\u2022 Reward Asset: tx:native  (\"reward_denom\": \"utestcore\" / \"ucore\")\n\u2022 Lockup Tiers (CodeID #4023): 30, 60 & 90 Days\n\u2022 Base Non-KYC Yield (\"non_kyc_apy_bps\"): 3.00% / 3.25% / 3.50% APY\n\u2022 KYC-Verified Yield (\"apy_bps\" via kyc_attestor): 6.00% / 6.50% / 7.00% APY (an exact 2.0x APY multiplier across every tier)\n\nThink about why this design is pure genius for Smart Money & @SoloTex_com:\n\n1\ufe0f\u20e3 Zero-Principal-Risk Exposure to tx:native (Ultimate Risk Management)\nSmart money coming to trade tokenized stocks & US T-Bills keeps its dry powder in $USTX. By paying $USTX staking rewards in tx:native, new investors get asymmetric upside exposure to the tx:native Layer-1 network with a $0 cost basis and zero principal risk to their dollar stack.\n\n2\ufe0f\u20e3 The 2.0x KYC Multiplier Is a No-Brainer for TradFi\nDeFi users can stake $USTX permissionlessly on Day 1. Meanwhile, TradFi investors\u2014who are already used to standard brokerage rails\u2014verify once to DOUBLE (2x) their $USTX APY while whitelisting their wallet for 5,000+ US Stocks & T-Bills via @texture_capital.\n\n3\ufe0f\u20e3 Turning Stablecoin Savers Into tx:native Buyers\nEvery $USTX staker automatically becomes a tx:native holder. Once smart money watches the speed, compliance, and RWA volume of the chain firsthand, they won't just wait to earn tx:native\u2014they'll buy it on the open market.\n\n4\ufe0f\u20e3 The Compounding RWA Loop No Bank Can Match\nLook at how resting capital compounds:\nResting $USTX earns a tx:native position \u27a1\ufe0f Hold/stake tx:native for network upside OR swap earned tx:native into more $USTX \u27a1\ufe0f Buy tokenized US Stocks & T-Bills paying real dividends & Treasury interest \u27a1\ufe0f Cycle T-Bills through the on-chain Repo Desk (CodeID #3988).\n\nProtected dollar principal, a 2x KYC yield multiplier paid in the L1 rail (tx:native), and 1-click compounding into yield-bearing RWAs. You cannot find this kind of value engine at any bank on earth. \u26a1\ufe0f",
    "createdAtTimestamp": 1793669554,
    "scoredAtTimestamp": 1793885308,
    "retweetCountAtCollection": 10,
    "favoriteCountAtCollection": 42,
    "replyCountAtCollection": 8,
    "quoteCountAtCollection": 4,
    "sentiment": 9,
    "alpha": 8,
    "legitimacy": 8,
    "technicalAccuracy": 7,
    "isRecent": true,
    "isVerifiable": true,
    "scoresReasoning": "The tweet describes a staking mechanism on the txEcosystem Testnet involving $USTX, a stablecoin issued by Brale, with rewards in tx:native. Google searches confirm that tx is a real-world asset (RWA) platform focused on tokenization, formed from the merger of Coreum and Sologenic. Brale is a U.S.-regulated stablecoin issuance platform that issues $USTX, which is backed 1:1 by U.S. dollar assets, including cash, bank deposits, government money market funds, and short-duration U.S. Treasury bills. The tx:native token is the native asset for network operations, staking, and governance within the tx ecosystem. The tweet's claims about staking $USTX for tx:native rewards and the existence of KYC-verified yield tiers are consistent with tx's stated goals and the involvement of regulated partners like Texture Capital and SoloTex. Texture Capital is a FINRA member and SEC-registered broker-dealer specializing in digital securities and tokenized real-world assets, including tokenized stocks and T-Bills. The tx Super App also mentions KYC and staking. While the specific smart contract CodeIDs (#4023 & #4024), exact lockup tiers (30, 60, 90 days), and precise APY percentages (3.00%/3.25%/3.50% and 6.00%/6.50%/7.00%) for the *testnet* are not directly verifiable through general public search results, the underlying mechanisms and the entities involved are legitimate and well-documented. The launch of USTX and related news are very recent (October 2026), indicating the information is current. The tweet presents a plausible, albeit detailed, description of a testnet configuration that aligns with the broader strategic direction of the tx ecosystem. The 'alpha' lies in the detailed breakdown of the staking mechanics and the explicit mention of the 2x KYC multiplier, which, if accurate, could be a significant incentive for institutional adoption.\n\nSources: [coingecko.com](https://www.coingecko.com/en/coins/tx) | [uphold.com](https://uphold.com/en-us/prices/crypto/tx) | [brale.com](https://brale.com/about) | [prnewswire.com](https://www.prnewswire.com/news-releases/brale-expands-custom-stablecoin-issuance-and-orchestration-platform-to-enterprise-grade-quantum-resistant-algorand-blockchain-302655564.html) | [tradersunion.com](https://tradersunion.com/news/cryptocurrency-news/show/3891179-tx-stablecoin-tokenized-stock-trading/) | [startupintros.com](https://startupintros.com/orgs/brale) | [globenewswire.com](https://www.globenewswire.com/news-release/2026/10/20/3384548/0/en/tx-launches-ustx-a-native-stablecoin-built-to-power-its-rwa-ecosystem.html) | [brale.xyz](https://brale.xyz/) | [visa.com](https://usa.visa.com/about-visa/newsroom/press-releases.releaseId.22481.html) | [youtube.com](https://www.youtube.com/watch?v=RN9WymfpuL4) | [kucoin.com](https://www.kucoin.com/news/flash/tx-launches-usd-stablecoin-ustx-for-tokenized-asset-trading) | [ct.com](https://ct.com)",
    "tweetUrl": "https://x.com/schwifftynhere/status/2117429699584327807",
    "userTrackRecordSignals": 1,
    "userTrackRecordUniqueTokens": 1,
    "userTrackRecordActiveDays": 1,
    "userTrackRecordFirstSignalDate": "2026-01-25",
    "userTrackRecordLastSignalDate": "2026-01-25",
    "userTrackRecordAccuracy24h": 0,
    "userTrackRecordAccuracy7d": 0,
    "userTrackRecordAccuracy30d": 0,
    "userTrackRecordAvgReturn24h": -6.69,
    "userTrackRecordAvgReturn7d": -24.52,
    "userTrackRecordAvgReturn30d": -6.73,
    "userTrackRecordBullishSignals": 1,
    "userTrackRecordBearishSignals": 0,
    "userTrackRecordAvgSentiment": 7,
    "userTrackRecordAvgAlpha": null,
    "userTrackRecordPerformanceTier": "unproven"
  }
]

This request returned 3 scored tweets (the collection is capped at the requested limit, 3 in this case): a strongly bullish $XMR post from an author with a 387-signal track record and 51.7% 24h accuracy, a bullish $KMNO post about Kamino's fixed-rate lending growth, and a bullish $TX post detailing a staking mechanism, from a first-time author with no established track record (userTrackRecordAvgAlpha is null).

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 through 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
1.0.0 Current No application/vnd.cambrian.deep42.social-data.alpha-tweet-detection.v1+json
2.0.0 Current Yes application/vnd.cambrian.deep42.social-data.alpha-tweet-detection.v2+json
2.1.0 Current No application/vnd.cambrian.deep42.social-data.alpha-tweet-detection.v2.1+json
3.0.0 Current No application/vnd.cambrian.deep42.social-data.alpha-tweet-detection.v3+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.v1+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 - Cryptocurrency influencers with recent activity and historical directional-price metrics
  • /deep42/social-data/sentiment-shifts - Tokens with significant sentiment changes that could signal market movements
  • /deep42/social-data/token-analysis - Comprehensive social intelligence report for a cryptocurrency token
  • /deep42/social-data/trending-momentum - Tokens with rapidly increasing social signals and momentum indicators