Cambrian Crypto Influencer Credibility Rankings API

By Cambrian Network deep42

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

Crypto Influencer Credibility Rankings

Overview

Returns a direct array of cryptocurrency influencers ranked by recent activity and historical directional-price performance. By default, the response groups accounts into proven, unproven, and insufficient-evidence tiers, then ranks each group by average direction-adjusted 7-day return versus Bitcoin. You can filter recent-activity metrics (tweet counts, views, engagement) independently from the all-history track record.

Business Value

  • Bitcoin-relative performance grading: Surfaces influencers whose historical calls actually beat Bitcoin, not just those with high raw accuracy or follower counts.
  • Evidence-weighted trust tiers: The proven/unproven/insufficientEvidence classification lets consumers filter out accounts with too little track record before acting on their calls.
  • Statistically conservative scoring: The Wilson-lower-bound conservative accuracy figure prevents small, lucky samples from outranking larger, more reliable track records.
  • Flexible activity windows: time_window and token_focus let integrators evaluate recent eligibility (e.g., last 48h SOL calls) while still ranking on the full historical track record.
  • Backward-compatible versioning: Legacy v2 activity-first scoring remains available via content negotiation, so existing integrations are unaffected by the v4 default.

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 number of qualifying tweets required in the activity window. Minimum: 1. Maximum: 100.
limit integer No 25 Maximum number of influencers to return. Minimum: 1. Maximum: 100.
token_focus string No - Only include influencers with qualifying recent activity for this token symbol. V3 and v4 treat it case-insensitively, normalize it to uppercase, and use it only for recent eligibility; the historical track record remains all-token. Pattern: ^[A-Za-z0-9]{1,10}$. Examples: BTC, sol.
sort_by string No return_vs_bitcoin Sort metric. Allowed values: influence, credibility, return_vs_bitcoin, win_rate_vs_bitcoin, tweets, engagement, reach, alpha, accuracy, conservative_accuracy. In v2, credibility is the legacy activity composite and accuracy is raw 30-day accuracy. In v3/v4, return_vs_bitcoin uses average direction-adjusted 7-day return relative to Bitcoin; win_rate_vs_bitcoin is the percentage of graded calls that beat Bitcoin; accuracy is raw 7-day directional accuracy; conservative_accuracy is the Wilson-adjusted estimate. V3 and v4 do not accept influence or credibility.
order string No desc Sort direction. Allowed values: asc, desc. In v3/v4, return_vs_bitcoin with desc groups proven, unproven, and insufficientEvidence accounts, then sorts each group by the selected return.
min_alpha integer No 6 V3 and v4 only. Minimum alpha score on the 0-10 scale, applied to recent eligibility tweets and historical directional signals. Minimum: 0. Maximum: 10.
min_outcomes_7d integer No 100 V3 and v4 only. Minimum number of graded 7-day calls with both token and Bitcoin prices. Minimum: 0. Use 0 to include accounts without a graded BTC-relative outcome (their BTC-relative metrics are null and sort last).
time_window string No 30d Recent activity window. V2 rounds hour values up to whole days. V3 and v4 use a positive Nh or Nd value as an exact trailing UTC interval, capped at 90 days, used only for recent eligibility. Pattern: ^[1-9][0-9]*[hd]$. Examples: 24h, 48h, 7d, 30d.

Response Field Descriptions

Response Field Type Description
twitterHandle string Twitter/X handle without @.
influenceScore number Legacy reach-weighted engagement score.
avgViewsPerTweet number Average views per qualifying recent tweet.
avgEngagementPerTweet number Average likes, reposts, and replies per qualifying recent tweet.
tokensCovered integer Distinct tokens in qualifying recent tweets. In v4.2+, tweets without an identified token are not counted.
totalReach integer Total views across qualifying recent tweets.
tweetCount integer V3 and v4. Qualifying recent tweet count after min_alpha, token_focus, and time_window filters.
avgAlpha number | null V3 and v4. Average alpha across qualifying recent tweets on the 0-10 scale; trackRecordAvgAlpha covers historical directional signals.
latestTweetAt string | null V3 and v4. Timestamp of the latest qualifying recent tweet (date-time).
trackRecordSignals integer | null Historical directional signals, including calls whose later price outcome is not yet resolved. Deduplicated to one call per influencer, token, direction, and UTC day; Bitcoin, wrapped Bitcoin, and common stablecoins are excluded.
trackRecordUniqueTokens integer | null Distinct tokens in the historical signal record.
trackRecordActiveDays integer | null Distinct UTC calendar days containing a historical signal.
trackRecordFirstSignalDate string | null Earliest historical signal date.
trackRecordLastSignalDate string | null Latest historical signal date.
trackRecordAccuracy24h number | null Raw 24-hour directional accuracy = correct resolved 24-hour calls / resolved 24-hour outcomes * 100. Range: 0-100.
trackRecordAccuracy7d number | null Raw 7-day directional accuracy = trackRecordCorrect7d / trackRecordOutcomes7d * 100. A bullish call is correct when the 7-day price is higher than the signal price; a bearish call is correct when it is lower. Range: 0-100.
trackRecordAccuracy30d number | null Raw 30-day directional accuracy = correct resolved 30-day calls / resolved 30-day outcomes * 100. Range: 0-100.
trackRecordCorrect24h integer V3 and v4. Resolved 24-hour outcomes whose price movement matched the call.
trackRecordOutcomes24h integer V3 and v4. Signals with a resolved 24-hour comparison price; the raw 24-hour accuracy denominator.
trackRecordCorrect7d integer V3 and v4. Resolved 7-day outcomes whose price movement matched the call.
trackRecordOutcomes7d integer V3 and v4. Signals with a resolved 7-day comparison price; the denominator for raw 7-day accuracy and the sample size used by conservative 7-day accuracy.
trackRecordCorrect30d integer V3 and v4. Resolved 30-day outcomes whose price movement matched the call.
trackRecordOutcomes30d integer V3 and v4. Signals with a resolved 30-day comparison price; the raw 30-day accuracy denominator.
trackRecordAvgReturn24h number | null Average direction-adjusted 24-hour return percentage. Bullish = (futurePrice - signalPrice) / signalPrice * 100; bearish = -(futurePrice - signalPrice) / signalPrice * 100.
trackRecordAvgReturn7d number | null Average direction-adjusted 7-day return percentage, same bullish/bearish formula as the 24-hour version.
trackRecordAvgReturn30d number | null Average direction-adjusted 30-day return percentage, same bullish/bearish formula as the 24-hour version.
trackRecordMaturedSignals24h integer V3 and v4. Deduplicated calls whose 24-hour target UTC date has been reached and is eligible for grading. Minimum: 0.
trackRecordUnavailable24h integer V3 and v4. Matured 24-hour calls missing either the token or Bitcoin comparison price. Reduces coverage but is not assumed to be a token death. Minimum: 0.
trackRecordCoverage24h number | null V3 and v4. Percentage of matured 24-hour calls graded against Bitcoin: 100 * trackRecordOutcomesVsBitcoin24h / trackRecordMaturedSignals24h. Null when none matured. Range: 0-100.
trackRecordOutcomesVsBitcoin24h integer V3 and v4. Graded 24-hour calls with both token and Bitcoin prices; denominator for trackRecordWinRateVsBitcoin24h. Minimum: 0.
trackRecordWinsVsBitcoin24h integer V3 and v4. Graded 24-hour calls whose direction-adjusted token return beat Bitcoin. Minimum: 0.
trackRecordWinRateVsBitcoin24h number | null V3 and v4. Percentage of graded 24-hour calls that beat Bitcoin: 100 * wins / graded calls. Null when no call is graded. Range: 0-100.
trackRecordAvgReturnVsBitcoin24h number | null V3 and v4. Average direction-adjusted 24-hour return relative to Bitcoin, in percentage points. Above 0 means calls beat Bitcoin on average. Bitcoin uses UTC-date prices; null when no call is graded.
trackRecordMaturedSignals7d integer V3 and v4. Deduplicated calls whose 7-day target UTC date has been reached and is eligible for grading. Minimum: 0.
trackRecordUnavailable7d integer V3 and v4. Matured 7-day calls missing either the token or Bitcoin comparison price. Reduces coverage but is not assumed to be a token death. Minimum: 0.
trackRecordCoverage7d number | null V3 and v4. Percentage of matured 7-day calls graded against Bitcoin: 100 * trackRecordOutcomesVsBitcoin7d / trackRecordMaturedSignals7d. At least 90% is required for a proven verdict; null when none matured. Range: 0-100.
trackRecordOutcomesVsBitcoin7d integer V3 and v4. Graded 7-day calls with both token and Bitcoin prices; denominator for trackRecordWinRateVsBitcoin7d and the evidence count used by min_outcomes_7d. Minimum: 0.
trackRecordWinsVsBitcoin7d integer V3 and v4. Graded 7-day calls whose direction-adjusted token return beat Bitcoin. Minimum: 0.
trackRecordWinRateVsBitcoin7d number | null V3 and v4. Percentage of graded 7-day calls that beat Bitcoin: 100 * trackRecordWinsVsBitcoin7d / trackRecordOutcomesVsBitcoin7d. Above 50 means a majority beat Bitcoin; null when no call is graded. Range: 0-100.
trackRecordAvgReturnVsBitcoin7d number | null V3 and v4. Average direction-adjusted 7-day return relative to Bitcoin, in percentage points. Above 0 means calls beat Bitcoin on average; this is a relative directional view, not literal portfolio profit. Null when no call is graded.
trackRecordMaturedSignals30d integer V3 and v4. Deduplicated calls whose 30-day target UTC date has been reached and is eligible for grading. Minimum: 0.
trackRecordUnavailable30d integer V3 and v4. Matured 30-day calls missing either the token or Bitcoin comparison price. Reduces coverage but is not assumed to be a token death. Minimum: 0.
trackRecordCoverage30d number | null V3 and v4. Percentage of matured 30-day calls graded against Bitcoin: 100 * trackRecordOutcomesVsBitcoin30d / trackRecordMaturedSignals30d. Null when none matured. Range: 0-100.
trackRecordOutcomesVsBitcoin30d integer V3 and v4. Graded 30-day calls with both token and Bitcoin prices; denominator for trackRecordWinRateVsBitcoin30d. Minimum: 0.
trackRecordWinsVsBitcoin30d integer V3 and v4. Graded 30-day calls whose direction-adjusted token return beat Bitcoin. Minimum: 0.
trackRecordWinRateVsBitcoin30d number | null V3 and v4. Percentage of graded 30-day calls that beat Bitcoin: 100 * wins / graded calls. Null when no call is graded. Range: 0-100.
trackRecordAvgReturnVsBitcoin30d number | null V3 and v4. Average direction-adjusted 30-day return relative to Bitcoin, in percentage points. Above 0 means calls beat Bitcoin on average. Bitcoin uses UTC-date prices; null when no call is graded.
trackRecordBullishSignals integer | null Historical bullish signal count.
trackRecordBearishSignals integer | null Historical bearish signal count.
trackRecordAvgSentiment number | null Average historical signal sentiment on the 0-10 scale.
trackRecordAvgAlpha number | null Average historical signal alpha on the 0-10 scale.
trackRecordPerformanceTier string | null Track Record Verdict. Allowed values: topPerformer, proven, unproven, insufficientEvidence, null. V2 uses raw 24-hour accuracy: topPerformer >=70%, proven >=60%, otherwise unproven. In v3/v4 this is a single Bitcoin-relative quality verdict: proven requires at least 100 graded 7-day calls versus Bitcoin, 30 active days, 3 tokens, at least 90% coverage, a win rate above 50%, positive average return versus Bitcoin, and positive average return after dropping the single best call; insufficientEvidence means a sample, activity, or diversity minimum was not met; unproven means enough evidence exists but a performance or coverage check failed.
trackRecordConservativeAccuracy7d number | null Conservative 7-Day Accuracy. A sample-size-adjusted estimate of 7-day directional accuracy (95% Wilson score lower bound), scaled 0-100. When two influencers have the same raw accuracy, the one with more resolved outcomes receives the higher conservative value. Null when trackRecordOutcomes7d is 0.

Examples

Top influencers by default ranking

Fetches the top 3 influencers using the default return_vs_bitcoin sort, which groups proven, unproven, and insufficient-evidence accounts and ranks each group by average direction-adjusted 7-day return versus Bitcoin.

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": 13,
    "avgViewsPerTweet": 138.08,
    "avgEngagementPerTweet": 39,
    "avgAlpha": 7.15,
    "latestTweetAt": "2026-09-29T04:45:00+00:00",
    "totalReach": 1795,
    "tokensCovered": 3,
    "influenceScore": 0.02,
    "trackRecordSignals": 117,
    "trackRecordUniqueTokens": 25,
    "trackRecordActiveDays": 92,
    "trackRecordCorrect24h": 35,
    "trackRecordOutcomes24h": 79,
    "trackRecordCorrect7d": 43,
    "trackRecordOutcomes7d": 107,
    "trackRecordCorrect30d": 40,
    "trackRecordOutcomes30d": 101,
    "trackRecordMaturedSignals24h": 117,
    "trackRecordMaturedSignals7d": 114,
    "trackRecordMaturedSignals30d": 110,
    "trackRecordOutcomesVsBitcoin24h": 78,
    "trackRecordWinsVsBitcoin24h": 36,
    "trackRecordOutcomesVsBitcoin7d": 106,
    "trackRecordWinsVsBitcoin7d": 57,
    "trackRecordOutcomesVsBitcoin30d": 101,
    "trackRecordWinsVsBitcoin30d": 49,
    "trackRecordBullishSignals": 106,
    "trackRecordBearishSignals": 11,
    "trackRecordFirstSignalDate": "2025-12-07",
    "trackRecordLastSignalDate": "2026-09-29",
    "trackRecordAvgReturn24h": -0.04,
    "trackRecordAvgReturn7d": 1.6,
    "trackRecordAvgReturn30d": -7.54,
    "trackRecordAvgReturnVsBitcoin24h": 0.26,
    "trackRecordAvgReturnVsBitcoin7d": 3.4,
    "trackRecordAvgReturnVsBitcoin30d": -0.87,
    "trackRecordAvgSentiment": 7.68,
    "trackRecordAvgAlpha": 7.38,
    "trackRecordAccuracy24h": 44.3,
    "trackRecordUnavailable24h": 39,
    "trackRecordCoverage24h": 66.67,
    "trackRecordWinRateVsBitcoin24h": 46.15,
    "trackRecordAccuracy7d": 40.19,
    "trackRecordUnavailable7d": 8,
    "trackRecordCoverage7d": 92.98,
    "trackRecordWinRateVsBitcoin7d": 53.77,
    "trackRecordAccuracy30d": 39.6,
    "trackRecordUnavailable30d": 9,
    "trackRecordCoverage30d": 91.82,
    "trackRecordWinRateVsBitcoin30d": 48.51,
    "trackRecordConservativeAccuracy7d": 31.39,
    "trackRecordPerformanceTier": "proven"
  },
  {
    "twitterHandle": "nahnah64",
    "tweetCount": 17,
    "avgViewsPerTweet": 446.29,
    "avgEngagementPerTweet": 9.47,
    "avgAlpha": 6,
    "latestTweetAt": "2026-09-30T09:47:54+00:00",
    "totalReach": 7587,
    "tokensCovered": 1,
    "influenceScore": 0.01,
    "trackRecordSignals": 199,
    "trackRecordUniqueTokens": 13,
    "trackRecordActiveDays": 153,
    "trackRecordCorrect24h": 44,
    "trackRecordOutcomes24h": 85,
    "trackRecordCorrect7d": 85,
    "trackRecordOutcomes7d": 179,
    "trackRecordCorrect30d": 112,
    "trackRecordOutcomes30d": 170,
    "trackRecordMaturedSignals24h": 198,
    "trackRecordMaturedSignals7d": 192,
    "trackRecordMaturedSignals30d": 181,
    "trackRecordOutcomesVsBitcoin24h": 82,
    "trackRecordWinsVsBitcoin24h": 40,
    "trackRecordOutcomesVsBitcoin7d": 175,
    "trackRecordWinsVsBitcoin7d": 89,
    "trackRecordOutcomesVsBitcoin30d": 170,
    "trackRecordWinsVsBitcoin30d": 118,
    "trackRecordBullishSignals": 180,
    "trackRecordBearishSignals": 19,
    "trackRecordFirstSignalDate": "2025-05-08",
    "trackRecordLastSignalDate": "2026-09-30",
    "trackRecordAvgReturn24h": 0.97,
    "trackRecordAvgReturn7d": 1.74,
    "trackRecordAvgReturn30d": 13.11,
    "trackRecordAvgReturnVsBitcoin24h": 0.83,
    "trackRecordAvgReturnVsBitcoin7d": 3.19,
    "trackRecordAvgReturnVsBitcoin30d": 17.92,
    "trackRecordAvgSentiment": 7.28,
    "trackRecordAvgAlpha": 7.08,
    "trackRecordAccuracy24h": 51.76,
    "trackRecordUnavailable24h": 116,
    "trackRecordCoverage24h": 41.41,
    "trackRecordWinRateVsBitcoin24h": 48.78,
    "trackRecordAccuracy7d": 47.49,
    "trackRecordUnavailable7d": 17,
    "trackRecordCoverage7d": 91.15,
    "trackRecordWinRateVsBitcoin7d": 50.86,
    "trackRecordAccuracy30d": 65.88,
    "trackRecordUnavailable30d": 11,
    "trackRecordCoverage30d": 93.92,
    "trackRecordWinRateVsBitcoin30d": 69.41,
    "trackRecordConservativeAccuracy7d": 40.3,
    "trackRecordPerformanceTier": "proven"
  },
  {
    "twitterHandle": "wiseadvicesumit",
    "tweetCount": 5,
    "avgViewsPerTweet": 4922,
    "avgEngagementPerTweet": 12.8,
    "avgAlpha": 6.4,
    "latestTweetAt": "2026-09-26T09:08:51+00:00",
    "totalReach": 24610,
    "tokensCovered": 5,
    "influenceScore": 0.01,
    "trackRecordSignals": 342,
    "trackRecordUniqueTokens": 143,
    "trackRecordActiveDays": 166,
    "trackRecordCorrect24h": 81,
    "trackRecordOutcomes24h": 136,
    "trackRecordCorrect7d": 172,
    "trackRecordOutcomes7d": 309,
    "trackRecordCorrect30d": 135,
    "trackRecordOutcomes30d": 303,
    "trackRecordMaturedSignals24h": 342,
    "trackRecordMaturedSignals7d": 340,
    "trackRecordMaturedSignals30d": 335,
    "trackRecordOutcomesVsBitcoin24h": 136,
    "trackRecordWinsVsBitcoin24h": 76,
    "trackRecordOutcomesVsBitcoin7d": 306,
    "trackRecordWinsVsBitcoin7d": 168,
    "trackRecordOutcomesVsBitcoin30d": 302,
    "trackRecordWinsVsBitcoin30d": 149,
    "trackRecordBullishSignals": 210,
    "trackRecordBearishSignals": 132,
    "trackRecordFirstSignalDate": "2025-02-15",
    "trackRecordLastSignalDate": "2026-09-27",
    "trackRecordAvgReturn24h": 1.67,
    "trackRecordAvgReturn7d": 2.67,
    "trackRecordAvgReturn30d": -2.33,
    "trackRecordAvgReturnVsBitcoin24h": 1.6,
    "trackRecordAvgReturnVsBitcoin7d": 3.07,
    "trackRecordAvgReturnVsBitcoin30d": 0.48,
    "trackRecordAvgSentiment": 5.93,
    "trackRecordAvgAlpha": 8.38,
    "trackRecordAccuracy24h": 59.56,
    "trackRecordUnavailable24h": 206,
    "trackRecordCoverage24h": 39.77,
    "trackRecordWinRateVsBitcoin24h": 55.88,
    "trackRecordAccuracy7d": 55.66,
    "trackRecordUnavailable7d": 34,
    "trackRecordCoverage7d": 90,
    "trackRecordWinRateVsBitcoin7d": 54.9,
    "trackRecordAccuracy30d": 44.55,
    "trackRecordUnavailable30d": 33,
    "trackRecordCoverage30d": 90.15,
    "trackRecordWinRateVsBitcoin30d": 49.34,
    "trackRecordConservativeAccuracy7d": 50.09,
    "trackRecordPerformanceTier": "proven"
  }
]

This request set limit=3, so the result array is capped at 3 influencers. All three returned accounts (gpaandy, nahnah64, wiseadvicesumit) carry a proven trackRecordPerformanceTier, each with over 100 graded 7-day calls versus Bitcoin and a positive trackRecordAvgReturnVsBitcoin7d.

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 No application/vnd.cambrian.deep42.social-data.influencer-credibility.v3+json
4.0.0 Current Yes application/vnd.cambrian.deep42.social-data.influencer-credibility.v4+json
4.1.0 Current No application/vnd.cambrian.deep42.social-data.influencer-credibility.v4.1+json
4.2.0 Current No application/vnd.cambrian.deep42.social-data.influencer-credibility.v4.2+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 you don't specify an Accept header, the API returns the default version (4.0.0).

Related Endpoints

  • /deep42/social-data/alpha-tweet-detection - Feed of tweets scored for sentiment, alpha, legitimacy, and technical accuracy, with author track records.
  • /deep42/social-data/sentiment-shifts - Identifies tokens with significant sentiment changes between two periods.
  • /deep42/social-data/token-analysis - Comprehensive social intelligence report for a single cryptocurrency token.
  • /deep42/social-data/trending-momentum - Identifies tokens with rapidly increasing social signals and momentum indicators.