Cambrian Crypto Influencer Credibility Rankings API

By Cambrian Network deep42

GET /api/v1/deep42/social-data/influencer-credibility

Influencer Credibility

Overview

Returns recently relevant cryptocurrency influencers ranked using a BTC-relative track record. The default descending ranking first groups accounts by Track Record Verdict (proven, then unproven, then insufficientEvidence) and then ranks each group by average direction-adjusted 7-day return relative to Bitcoin, the fixed benchmark. Each result also exposes BTC-relative win rates, graded and unavailable call counts, data coverage, raw directional accuracy and returns, and an optional conservative accuracy estimate.

Business Value

  • Identify Reliable Voices: Find the most credible cryptocurrency influencers based on comprehensive metrics including engagement, reach, and track record accuracy
  • Track Record Analysis: Analyze historical performance with directional price predictions measured at 24h, 7d, and 30d timeframes
  • Performance-Based Filtering: Filter influencers by activity level, token focus, and proven track records to find relevant voices for specific use cases
  • Risk Assessment: Evaluate influencer performance tiers (topPerformer >=70% accuracy, proven >=60%, unproven <60%) for informed decision making
  • Social Intelligence: Access detailed engagement metrics, reach data, and sentiment analysis to understand influencer impact and reliability

Endpoint Details

URL:

https://api.cambrian.org/deep42/social-data/influencer-credibility

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

Query Parameters

Parameter Type Required Default Description
min_tweets integer No 5 Minimum qualifying tweets an influencer must have in the recent activity window. Range 1-100.
min_alpha integer No 6 Minimum alpha score on the 0-10 scale. Applied to recent eligibility tweets and to historical directional signals included in the track record.
min_outcomes_7d integer No 100 Minimum number of graded 7-day calls with both token and Bitcoin prices required. Lower values are exploratory; set 0 to include accounts without graded BTC-relative outcomes, whose BTC-relative metrics are null and sort last.
limit integer No 25 Maximum number of influencers returned after global filtering and sorting. Range 1-100.
token_focus string No - Case-insensitive token symbol used only to qualify recent activity (normalized to uppercase). Historical track records remain cross-token and apply the documented benchmark-token exclusions. Pattern ^[A-Za-z0-9]{1,10}$.
sort_by string No return_vs_bitcoin Ranking metric: return_vs_bitcoin, win_rate_vs_bitcoin, accuracy, conservative_accuracy, tweets, alpha, engagement, reach. With the default and descending order, accounts are grouped first by Track Record Verdict.
order string No desc Sort direction: asc or desc. With the default return_vs_bitcoin/desc combination, Track Record Verdict is the primary ordering; other combinations sort directly by the selected metric.
time_window string No 30d Exact trailing UTC interval used only to qualify recent activity. A positive number followed by h (hours) or d (days), up to 90 days; historical track records remain all-history. Pattern ^[1-9][0-9]*[hd]$.

Response Field Descriptions

Response Field Type Description
twitterHandle string Twitter/X handle without @. Numeric-only handles are excluded and case variants are deduplicated.
influenceScore number Reach-weighted engagement score over qualifying recent tweets.
avgViewsPerTweet number Average views per qualifying recent tweet.
avgEngagementPerTweet number Average likes, reposts, and replies per qualifying recent tweet.
trackRecordConservativeAccuracy7d number | null Conservative 7-day directional accuracy adjusted for sample size (0-100), the lower bound of a 95% Wilson-method confidence interval for raw 7-day accuracy. Null when trackRecordOutcomes7d = 0.
tokensCovered integer Distinct tokens among qualifying recent tweets.
totalReach integer Total views across qualifying recent tweets.
tweetCount integer Number of qualifying recent tweets after min_alpha, token_focus, and time_window filters.
avgAlpha number | null Average alpha score (0-10) across qualifying recent tweets. Differs from trackRecordAvgAlpha, which covers historical directional signals.
latestTweetAt string (date-time) | null Timestamp of the most recent qualifying tweet.
trackRecordSignals integer Deduplicated historical directional calls meeting min_alpha, including calls without prices. One call kept per influencer/token/direction/UTC day; Bitcoin, wrapped Bitcoin, and stablecoins excluded.
trackRecordUniqueTokens integer Distinct tokens represented by the historical directional signals.
trackRecordActiveDays integer Distinct UTC calendar days containing a historical directional signal.
trackRecordFirstSignalDate string (date) | null Earliest historical directional signal date.
trackRecordLastSignalDate string (date) | null Latest historical directional signal date.
trackRecordAccuracy24h number | null Raw 24-hour directional accuracy: 100 * trackRecordCorrect24h / trackRecordOutcomes24h. Null when unresolved.
trackRecordAccuracy7d number | null Raw 7-day directional accuracy = trackRecordCorrect7d / trackRecordOutcomes7d * 100. Null when unresolved.
trackRecordAccuracy30d number | null Raw 30-day directional accuracy: 100 * trackRecordCorrect30d / trackRecordOutcomes30d. Null when unresolved.
trackRecordCorrect24h integer Resolved 24-hour outcomes whose price movement matched the bullish or bearish call.
trackRecordOutcomes24h integer Signals with an available 24-hour comparison price; denominator for trackRecordAccuracy24h.
trackRecordCorrect7d integer Resolved 7-day outcomes whose price movement matched the call.
trackRecordOutcomes7d integer Signals with an available 7-day comparison price; denominator for raw and conservative 7-day accuracy.
trackRecordCorrect30d integer Resolved 30-day outcomes whose price movement matched the call.
trackRecordOutcomes30d integer Signals with an available 30-day comparison price; denominator for trackRecordAccuracy30d.
trackRecordAvgReturn24h number | null Average direction-adjusted 24-hour return %. Bullish = (futurePrice - signalPrice)/signalPrice*100; bearish = negated.
trackRecordAvgReturn7d number | null Average direction-adjusted 7-day return %, same formula as the 24h version.
trackRecordAvgReturn30d number | null Average direction-adjusted 30-day return %, same formula as the 24h version.
trackRecordMaturedSignals24h integer Deduplicated calls whose 24-hour target UTC date has been reached and is eligible for grading.
trackRecordUnavailable24h integer Matured 24-hour calls missing either the token or Bitcoin comparison price. Visible; not assumed as token deaths.
trackRecordCoverage24h number | null % of matured 24-hour calls graded against Bitcoin: 100 * trackRecordOutcomesVsBitcoin24h / trackRecordMaturedSignals24h. Null when no call has matured.
trackRecordOutcomesVsBitcoin24h integer Graded 24-hour calls with both token and Bitcoin prices; denominator for trackRecordWinRateVsBitcoin24h.
trackRecordWinsVsBitcoin24h integer Graded 24-hour calls whose direction-adjusted token return beat Bitcoin.
trackRecordWinRateVsBitcoin24h number | null % of graded 24-hour calls that beat Bitcoin. Above 50 means majority beat Bitcoin. Null when no call is graded.
trackRecordAvgReturnVsBitcoin24h number | null Average direction-adjusted 24-hour return relative to Bitcoin (percentage points). Above 0 means calls beat Bitcoin on average.
trackRecordMaturedSignals7d integer Deduplicated calls whose 7-day target UTC date has been reached and is eligible for grading.
trackRecordUnavailable7d integer Matured 7-day calls missing either the token or Bitcoin comparison price.
trackRecordCoverage7d number | null % of matured 7-day calls graded against Bitcoin; at least 90 required for a proven verdict. Null when no call has matured.
trackRecordOutcomesVsBitcoin7d integer Graded 7-day calls with both token and Bitcoin prices; denominator for trackRecordWinRateVsBitcoin7d and the evidence count used by min_outcomes_7d.
trackRecordWinsVsBitcoin7d integer Graded 7-day calls whose direction-adjusted token return beat Bitcoin.
trackRecordWinRateVsBitcoin7d number | null % of graded 7-day calls that beat Bitcoin. Null when no call is graded.
trackRecordAvgReturnVsBitcoin7d number | null Average direction-adjusted 7-day return relative to Bitcoin (percentage points). Measures relative directional view, not literal portfolio profit.
trackRecordMaturedSignals30d integer Deduplicated calls whose 30-day target UTC date has been reached and is eligible for grading.
trackRecordUnavailable30d integer Matured 30-day calls missing either the token or Bitcoin comparison price.
trackRecordCoverage30d number | null % of matured 30-day calls graded against Bitcoin. Null when no call has matured.
trackRecordOutcomesVsBitcoin30d integer Graded 30-day calls with both token and Bitcoin prices; denominator for trackRecordWinRateVsBitcoin30d.
trackRecordWinsVsBitcoin30d integer Graded 30-day calls whose direction-adjusted token return beat Bitcoin.
trackRecordWinRateVsBitcoin30d number | null % of graded 30-day calls that beat Bitcoin. Null when no call is graded.
trackRecordAvgReturnVsBitcoin30d number | null Average direction-adjusted 30-day return relative to Bitcoin (percentage points).
trackRecordBullishSignals integer Historical bullish signal count.
trackRecordBearishSignals integer Historical bearish signal count.
trackRecordAvgSentiment number | null Average sentiment (0-10) across historical directional signals.
trackRecordAvgAlpha number | null Average alpha (0-10) across all-history, all-token directional signals meeting min_alpha.
trackRecordPerformanceTier string Track Record Verdict: proven, unproven, or insufficientEvidence. proven requires ≥100 graded 7-day calls vs. Bitcoin, 30 active days, 3 tokens, ≥90% 7-day coverage, a win rate above 50%, positive average return vs. Bitcoin, and positive average return after dropping the single best call. insufficientEvidence means a sample/activity/diversity minimum was not met; unproven means enough evidence exists but a performance or coverage check failed.

Examples

Top influencers by BTC-relative track record

Retrieves the top 3 influencers ranked by the default return_vs_bitcoin sort, grouped first by Track Record Verdict.

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

Response:

[
  {
    "twitterHandle": "gpaandy",
    "tweetCount": 5,
    "avgViewsPerTweet": 189.6,
    "avgEngagementPerTweet": 29.4,
    "avgAlpha": 7.4,
    "latestTweetAt": "2026-08-19T06:00:01+00:00",
    "totalReach": 948,
    "tokensCovered": 3,
    "influenceScore": 0.01,
    "trackRecordSignals": 110,
    "trackRecordUniqueTokens": 23,
    "trackRecordActiveDays": 86,
    "trackRecordCorrect24h": 31,
    "trackRecordOutcomes24h": 72,
    "trackRecordCorrect7d": 42,
    "trackRecordOutcomes7d": 101,
    "trackRecordCorrect30d": 40,
    "trackRecordOutcomes30d": 100,
    "trackRecordMaturedSignals24h": 110,
    "trackRecordMaturedSignals7d": 108,
    "trackRecordMaturedSignals30d": 105,
    "trackRecordOutcomesVsBitcoin24h": 72,
    "trackRecordWinsVsBitcoin24h": 31,
    "trackRecordOutcomesVsBitcoin7d": 101,
    "trackRecordWinsVsBitcoin7d": 54,
    "trackRecordOutcomesVsBitcoin30d": 100,
    "trackRecordWinsVsBitcoin30d": 48,
    "trackRecordBullishSignals": 99,
    "trackRecordBearishSignals": 11,
    "trackRecordFirstSignalDate": "2025-12-07",
    "trackRecordLastSignalDate": "2026-08-15",
    "trackRecordAvgReturn24h": -0.06,
    "trackRecordAvgReturn7d": 2.09,
    "trackRecordAvgReturn30d": -7.57,
    "trackRecordAvgReturnVsBitcoin24h": 0.31,
    "trackRecordAvgReturnVsBitcoin7d": 3.61,
    "trackRecordAvgReturnVsBitcoin30d": -1.07,
    "trackRecordAvgSentiment": 7.68,
    "trackRecordAvgAlpha": 7.42,
    "trackRecordAccuracy24h": 43.06,
    "trackRecordUnavailable24h": 38,
    "trackRecordCoverage24h": 65.45,
    "trackRecordWinRateVsBitcoin24h": 43.06,
    "trackRecordAccuracy7d": 41.58,
    "trackRecordUnavailable7d": 7,
    "trackRecordCoverage7d": 93.52,
    "trackRecordWinRateVsBitcoin7d": 53.47,
    "trackRecordAccuracy30d": 40,
    "trackRecordUnavailable30d": 5,
    "trackRecordCoverage30d": 95.24,
    "trackRecordWinRateVsBitcoin30d": 48,
    "trackRecordConservativeAccuracy7d": 32.45,
    "trackRecordPerformanceTier": "proven"
  },
  {
    "twitterHandle": "skadbsgml93",
    "tweetCount": 18,
    "avgViewsPerTweet": 451.56,
    "avgEngagementPerTweet": 25.33,
    "avgAlpha": 7,
    "latestTweetAt": "2026-07-28T23:11:42+00:00",
    "totalReach": 8128,
    "tokensCovered": 9,
    "influenceScore": 0.04,
    "trackRecordSignals": 212,
    "trackRecordUniqueTokens": 35,
    "trackRecordActiveDays": 59,
    "trackRecordCorrect24h": 90,
    "trackRecordOutcomes24h": 203,
    "trackRecordCorrect7d": 78,
    "trackRecordOutcomes7d": 203,
    "trackRecordCorrect30d": 34,
    "trackRecordOutcomes30d": 161,
    "trackRecordMaturedSignals24h": 212,
    "trackRecordMaturedSignals7d": 212,
    "trackRecordMaturedSignals30d": 178,
    "trackRecordOutcomesVsBitcoin24h": 203,
    "trackRecordWinsVsBitcoin24h": 98,
    "trackRecordOutcomesVsBitcoin7d": 203,
    "trackRecordWinsVsBitcoin7d": 104,
    "trackRecordOutcomesVsBitcoin30d": 159,
    "trackRecordWinsVsBitcoin30d": 97,
    "trackRecordBullishSignals": 212,
    "trackRecordBearishSignals": 0,
    "trackRecordFirstSignalDate": "2026-04-28",
    "trackRecordLastSignalDate": "2026-07-30",
    "trackRecordAvgReturn24h": -0.07,
    "trackRecordAvgReturn7d": 0.15,
    "trackRecordAvgReturn30d": -8.74,
    "trackRecordAvgReturnVsBitcoin24h": 0.14,
    "trackRecordAvgReturnVsBitcoin7d": 3.07,
    "trackRecordAvgReturnVsBitcoin30d": 5.96,
    "trackRecordAvgSentiment": 8.97,
    "trackRecordAvgAlpha": 7.1,
    "trackRecordAccuracy24h": 44.33,
    "trackRecordUnavailable24h": 9,
    "trackRecordCoverage24h": 95.75,
    "trackRecordWinRateVsBitcoin24h": 48.28,
    "trackRecordAccuracy7d": 38.42,
    "trackRecordUnavailable7d": 9,
    "trackRecordCoverage7d": 95.75,
    "trackRecordWinRateVsBitcoin7d": 51.23,
    "trackRecordAccuracy30d": 21.12,
    "trackRecordUnavailable30d": 19,
    "trackRecordCoverage30d": 89.33,
    "trackRecordWinRateVsBitcoin30d": 61.01,
    "trackRecordConservativeAccuracy7d": 32.01,
    "trackRecordPerformanceTier": "proven"
  },
  {
    "twitterHandle": "wiseadvicesumit",
    "tweetCount": 11,
    "avgViewsPerTweet": 4958.91,
    "avgEngagementPerTweet": 22.18,
    "avgAlpha": 7.73,
    "latestTweetAt": "2026-08-16T04:53:32+00:00",
    "totalReach": 54548,
    "tokensCovered": 7,
    "influenceScore": 0.02,
    "trackRecordSignals": 334,
    "trackRecordUniqueTokens": 140,
    "trackRecordActiveDays": 160,
    "trackRecordCorrect24h": 77,
    "trackRecordOutcomes24h": 128,
    "trackRecordCorrect7d": 168,
    "trackRecordOutcomes7d": 301,
    "trackRecordCorrect30d": 131,
    "trackRecordOutcomes30d": 292,
    "trackRecordMaturedSignals24h": 334,
    "trackRecordMaturedSignals7d": 334,
    "trackRecordMaturedSignals30d": 325,
    "trackRecordOutcomesVsBitcoin24h": 128,
    "trackRecordWinsVsBitcoin24h": 73,
    "trackRecordOutcomesVsBitcoin7d": 301,
    "trackRecordWinsVsBitcoin7d": 164,
    "trackRecordOutcomesVsBitcoin30d": 292,
    "trackRecordWinsVsBitcoin30d": 143,
    "trackRecordBullishSignals": 205,
    "trackRecordBearishSignals": 129,
    "trackRecordFirstSignalDate": "2025-02-15",
    "trackRecordLastSignalDate": "2026-08-11",
    "trackRecordAvgReturn24h": 1.85,
    "trackRecordAvgReturn7d": 2.82,
    "trackRecordAvgReturn30d": -2.32,
    "trackRecordAvgReturnVsBitcoin24h": 1.8,
    "trackRecordAvgReturnVsBitcoin7d": 3.06,
    "trackRecordAvgReturnVsBitcoin30d": 0.41,
    "trackRecordAvgSentiment": 5.93,
    "trackRecordAvgAlpha": 8.43,
    "trackRecordAccuracy24h": 60.16,
    "trackRecordUnavailable24h": 206,
    "trackRecordCoverage24h": 38.32,
    "trackRecordWinRateVsBitcoin24h": 57.03,
    "trackRecordAccuracy7d": 55.81,
    "trackRecordUnavailable7d": 33,
    "trackRecordCoverage7d": 90.12,
    "trackRecordWinRateVsBitcoin7d": 54.49,
    "trackRecordAccuracy30d": 44.86,
    "trackRecordUnavailable30d": 33,
    "trackRecordCoverage30d": 89.85,
    "trackRecordWinRateVsBitcoin30d": 48.97,
    "trackRecordConservativeAccuracy7d": 50.17,
    "trackRecordPerformanceTier": "proven"
  }
]

This example result set is limited to 3 items via limit=3. All three returned influencers carry a proven Track Record Verdict; wiseadvicesumit shows the highest 7-day conservative accuracy (50.17) backed by 301 graded 7-day calls versus Bitcoin, while gpaandy and skadbsgml93 have smaller graded 7-day samples (101 and 203, respectively).

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.influencer-credibility.v1+json
2.0.0 Current No application/vnd.cambrian.deep42.social-data.influencer-credibility.v2+json
3.0.0 Current Yes application/vnd.cambrian.deep42.social-data.influencer-credibility.v3+json

How to Request a Specific Version

curl -X GET "https://api.cambrian.org/deep42/social-data/influencer-credibility" \
  -H "X-API-KEY: YOUR_API_KEY" \
  -H "Accept: application/vnd.cambrian.deep42.social-data.influencer-credibility.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 API returns the default version (3.0.0).

Related Endpoints

  • /deep42/social-data/alpha-tweet-detection - Feed of tweets detected as having high alpha potential for cryptocurrency investments, scored on sentiment, alpha, legitimacy, and technical accuracy.
  • /deep42/social-data/sentiment-shifts - Identifies tokens with significant sentiment changes between two equal-length periods that could signal market movements.
  • /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.