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. Each influencer row combines recent engagement metrics with a Bitcoin-relative track record built from deduplicated directional calls. The default response groups accounts into proven, unproven, and insufficient-evidence tiers before sorting each tier by average direction-adjusted 7-day return versus Bitcoin.

Business Value

  • Bitcoin-relative performance ranking: Surfaces influencers whose historical calls beat Bitcoin on a direction-adjusted basis, rather than raw price movement alone.
  • Evidence-based tiering: Separates proven track records from unproven or insufficient-evidence accounts using sample-size, activity, and diversity thresholds.
  • Conservative accuracy estimate: Applies a Wilson score lower bound to 7-day accuracy so influencers with larger, more reliable sample sizes aren't overstated by small-sample luck.
  • Token-focused discovery: Filters recent eligibility by token symbol and time window while preserving each influencer's full historical track record.
  • Pageable rankings: Supports paging through the complete ranked list via offset and limit for building leaderboards or bulk exports.

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. Min 1, max 100.
limit integer No 25 Maximum number of influencers to return. Min 1, max 300.
offset integer No - Number of ranked influencers to skip before the first returned row. Use with limit to page through the full ranked list. Min 0. A response with fewer than limit rows is the last page. Rows can move between pages when new data arrives between two requests.
handle string No - X handle of one account, with or without a leading @. Case-insensitive match. Pattern: ^@?[A-Za-z0-9_]{1,15}$. Returns only that account's row regardless of rank, limit, or offset. Returns an empty array when the account does not meet the filters, and 404 when the account has no posts.
include_calls boolean No - Set to true with handle to add the account's individual calls in a calls list. A call is one token and direction on one UTC day; the track-record totals on the row are computed from these calls.
token_focus string No - Only include influencers with qualifying recent activity for this token symbol. Pattern: ^[A-Za-z0-9]{1,10}$. Treated case-insensitively and normalized to uppercase; used only for recent eligibility, not the historical track record.
sort_by string No return_vs_bitcoin Sort metric. Allowed values: return_vs_bitcoin, win_rate_vs_bitcoin, accuracy, conservative_accuracy, tweets, alpha, engagement, reach. With return_vs_bitcoin and descending order, the Track Record Verdict is applied first.
order string No desc Sort direction. Allowed values: asc, desc. With return_vs_bitcoin and desc, accounts are grouped as proven, unproven, then insufficientEvidence before sorting each group by the selected return.
min_alpha integer No 6 Minimum alpha score on the 0-10 scale, applied to recent eligibility tweets and historical directional signals. Min 0, max 10.
min_outcomes_7d integer No 100 Minimum number of graded 7-day calls with both token and Bitcoin prices. Lower values are exploratory; use 0 to include accounts without a graded BTC-relative outcome (their BTC-relative metrics are null and sort last). Min 0.
time_window string No 30d Recent activity window. Pattern: ^[1-9][0-9]*[hd]$ (e.g. 24h, 48h, 7d, 30d). Used as an exact trailing UTC interval, capped at 90 days, and applied only to recent eligibility; the historical track record remains all-history.

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.
totalReach integer Total views across qualifying recent tweets.
tweetCount integer Qualifying recent tweet count after min_alpha, token_focus, and time_window filters.
avgAlpha number | null Average alpha across qualifying recent tweets; trackRecordAvgAlpha covers historical directional signals.
latestTweetAt string | null Timestamp of the latest qualifying recent tweet.
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 Resolved 24-hour outcomes whose price movement matched the call.
trackRecordOutcomes24h integer Signals with a resolved 24-hour comparison price; the raw 24-hour accuracy denominator.
trackRecordCorrect7d integer Resolved 7-day outcomes whose price movement matched the call.
trackRecordOutcomes7d integer 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 Resolved 30-day outcomes whose price movement matched the call.
trackRecordOutcomes30d integer 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 is the negation.
trackRecordAvgReturn7d number | null Average direction-adjusted 7-day return percentage, computed the same way as the 24-hour return.
trackRecordAvgReturn30d number | null Average direction-adjusted 30-day return percentage, computed the same way as the 24-hour return.
trackRecordMaturedSignals24h integer Deduplicated calls whose 24-hour target UTC date has been reached and is eligible for grading. Min 0.
trackRecordUnavailable24h integer Matured 24-hour calls missing either the token or Bitcoin comparison price. Reduces coverage but is not assumed to indicate a token death. Min 0.
trackRecordCoverage24h number | null Percentage of matured 24-hour calls graded against Bitcoin: 100 * trackRecordOutcomesVsBitcoin24h / trackRecordMaturedSignals24h. Range 0-100; null when none matured.
trackRecordOutcomesVsBitcoin24h integer Graded 24-hour calls with both token and Bitcoin prices; denominator for trackRecordWinRateVsBitcoin24h. Min 0.
trackRecordWinsVsBitcoin24h integer Graded 24-hour calls whose direction-adjusted token return beat Bitcoin. Min 0.
trackRecordWinRateVsBitcoin24h number | null Percentage of graded 24-hour calls that beat Bitcoin: 100 * wins / graded calls. Range 0-100; null when no call is graded.
trackRecordAvgReturnVsBitcoin24h number | null 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 Deduplicated calls whose 7-day target UTC date has been reached and is eligible for grading. Min 0.
trackRecordUnavailable7d integer Matured 7-day calls missing either the token or Bitcoin comparison price. Reduces coverage but is not assumed to indicate a token death. Min 0.
trackRecordCoverage7d number | null Percentage of matured 7-day calls graded against Bitcoin: 100 * trackRecordOutcomesVsBitcoin7d / trackRecordMaturedSignals7d. At least 90% is required for a proven verdict. Range 0-100; null when none 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. Min 0.
trackRecordWinsVsBitcoin7d integer Graded 7-day calls whose direction-adjusted token return beat Bitcoin. Min 0.
trackRecordWinRateVsBitcoin7d number | null Percentage of graded 7-day calls that beat Bitcoin: 100 * trackRecordWinsVsBitcoin7d / trackRecordOutcomesVsBitcoin7d. Above 50 means a majority beat Bitcoin. Range 0-100; null when no call is graded.
trackRecordAvgReturnVsBitcoin7d number | null Average direction-adjusted 7-day return relative to Bitcoin, in percentage points. Above 0 means calls beat Bitcoin on average. A relative directional view, not literal portfolio profit; null when no call is graded.
trackRecordAvgReturnVsBitcoin7dWithoutBestCall number | null Average direction-adjusted 7-day return versus Bitcoin, in percentage points, with the account's single best call removed. One of the checks for the proven verdict, which requires a value above 0. Null when fewer than two calls are graded.
calls array Present only when include_calls is true. The account's calls, newest first. A call is one token and direction on one UTC day; several posts about the same token and direction on one day count as one call. The track-record totals on the row are computed from these calls. Returns are not rounded, so each total can be recomputed exactly.
trackRecordMaturedSignals30d integer Deduplicated calls whose 30-day target UTC date has been reached and is eligible for grading. Min 0.
trackRecordUnavailable30d integer Matured 30-day calls missing either the token or Bitcoin comparison price. Reduces coverage but is not assumed to indicate a token death. Min 0.
trackRecordCoverage30d number | null Percentage of matured 30-day calls graded against Bitcoin: 100 * trackRecordOutcomesVsBitcoin30d / trackRecordMaturedSignals30d. Range 0-100; null when none matured.
trackRecordOutcomesVsBitcoin30d integer Graded 30-day calls with both token and Bitcoin prices; denominator for trackRecordWinRateVsBitcoin30d. Min 0.
trackRecordWinsVsBitcoin30d integer Graded 30-day calls whose direction-adjusted token return beat Bitcoin. Min 0.
trackRecordWinRateVsBitcoin30d number | null Percentage of graded 30-day calls that beat Bitcoin: 100 * wins / graded calls. Range 0-100; null when no call is graded.
trackRecordAvgReturnVsBitcoin30d number | null Average direction-adjusted 30-day return relative to Bitcoin, in percentage points. Above 0 means calls beat Bitcoin on average; 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, or null. 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 A cautious, sample-size-adjusted estimate of 7-day directional accuracy (0-100), representing the lower end of a 95% confidence interval via the Wilson score lower bound. Not raw accuracy or a prediction of the next call; null when no 7-day outcomes are resolved.

Examples

Default ranked leaderboard

Retrieves the top-ranked influencers using all default filters and sorting, limited to 3 results.

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": "cryptopatel",
    "tweetCount": 87,
    "avgViewsPerTweet": 4079.91,
    "avgEngagementPerTweet": 165.71,
    "avgAlpha": 6.99,
    "latestTweetAt": "2026-11-11T18:29:00+00:00",
    "totalReach": 354952,
    "tokensCovered": 45,
    "influenceScore": 1.34,
    "trackRecordSignals": 325,
    "trackRecordUniqueTokens": 179,
    "trackRecordActiveDays": 183,
    "trackRecordCorrect24h": 148,
    "trackRecordOutcomes24h": 295,
    "trackRecordCorrect7d": 150,
    "trackRecordOutcomes7d": 290,
    "trackRecordCorrect30d": 135,
    "trackRecordOutcomes30d": 264,
    "trackRecordMaturedSignals24h": 325,
    "trackRecordMaturedSignals7d": 319,
    "trackRecordMaturedSignals30d": 295,
    "trackRecordOutcomesVsBitcoin24h": 295,
    "trackRecordWinsVsBitcoin24h": 150,
    "trackRecordOutcomesVsBitcoin7d": 290,
    "trackRecordWinsVsBitcoin7d": 151,
    "trackRecordOutcomesVsBitcoin30d": 264,
    "trackRecordWinsVsBitcoin30d": 149,
    "trackRecordBullishSignals": 153,
    "trackRecordBearishSignals": 172,
    "trackRecordFirstSignalDate": "2025-12-09",
    "trackRecordLastSignalDate": "2026-11-11",
    "trackRecordAvgReturn24h": 1.04,
    "trackRecordAvgReturn7d": 0.7,
    "trackRecordAvgReturn30d": -1.95,
    "trackRecordAvgReturnVsBitcoin24h": 0.92,
    "trackRecordAvgReturnVsBitcoin7d": 1.77,
    "trackRecordAvgReturnVsBitcoin30d": 2.24,
    "trackRecordAvgSentiment": 4.58,
    "trackRecordAvgAlpha": 7.5,
    "trackRecordAccuracy24h": 50.17,
    "trackRecordUnavailable24h": 30,
    "trackRecordCoverage24h": 90.77,
    "trackRecordWinRateVsBitcoin24h": 50.85,
    "trackRecordAccuracy7d": 51.72,
    "trackRecordUnavailable7d": 29,
    "trackRecordCoverage7d": 90.91,
    "trackRecordWinRateVsBitcoin7d": 52.07,
    "trackRecordAccuracy30d": 51.14,
    "trackRecordUnavailable30d": 31,
    "trackRecordCoverage30d": 89.49,
    "trackRecordWinRateVsBitcoin30d": 56.44,
    "trackRecordConservativeAccuracy7d": 45.99,
    "trackRecordPerformanceTier": "proven",
    "trackRecordAvgReturnVsBitcoin7dWithoutBestCall": 1.51
  },
  {
    "twitterHandle": "whalefactor",
    "tweetCount": 55,
    "avgViewsPerTweet": 11758.2,
    "avgEngagementPerTweet": 77.76,
    "avgAlpha": 7.09,
    "latestTweetAt": "2026-11-11T06:45:11+00:00",
    "totalReach": 646701,
    "tokensCovered": 28,
    "influenceScore": 0.4,
    "trackRecordSignals": 143,
    "trackRecordUniqueTokens": 44,
    "trackRecordActiveDays": 107,
    "trackRecordCorrect24h": 69,
    "trackRecordOutcomes24h": 137,
    "trackRecordCorrect7d": 60,
    "trackRecordOutcomes7d": 133,
    "trackRecordCorrect30d": 70,
    "trackRecordOutcomes30d": 119,
    "trackRecordMaturedSignals24h": 143,
    "trackRecordMaturedSignals7d": 139,
    "trackRecordMaturedSignals30d": 128,
    "trackRecordOutcomesVsBitcoin24h": 137,
    "trackRecordWinsVsBitcoin24h": 69,
    "trackRecordOutcomesVsBitcoin7d": 133,
    "trackRecordWinsVsBitcoin7d": 67,
    "trackRecordOutcomesVsBitcoin30d": 119,
    "trackRecordWinsVsBitcoin30d": 69,
    "trackRecordBullishSignals": 127,
    "trackRecordBearishSignals": 16,
    "trackRecordFirstSignalDate": "2026-01-24",
    "trackRecordLastSignalDate": "2026-11-10",
    "trackRecordAvgReturn24h": -0.14,
    "trackRecordAvgReturn7d": 0.6,
    "trackRecordAvgReturn30d": 3.55,
    "trackRecordAvgReturnVsBitcoin24h": 0.02,
    "trackRecordAvgReturnVsBitcoin7d": 1.32,
    "trackRecordAvgReturnVsBitcoin30d": 3.83,
    "trackRecordAvgSentiment": 7.22,
    "trackRecordAvgAlpha": 6.92,
    "trackRecordAccuracy24h": 50.36,
    "trackRecordUnavailable24h": 6,
    "trackRecordCoverage24h": 95.8,
    "trackRecordWinRateVsBitcoin24h": 50.36,
    "trackRecordAccuracy7d": 45.11,
    "trackRecordUnavailable7d": 6,
    "trackRecordCoverage7d": 95.68,
    "trackRecordWinRateVsBitcoin7d": 50.38,
    "trackRecordAccuracy30d": 58.82,
    "trackRecordUnavailable30d": 9,
    "trackRecordCoverage30d": 92.97,
    "trackRecordWinRateVsBitcoin30d": 57.98,
    "trackRecordConservativeAccuracy7d": 36.91,
    "trackRecordPerformanceTier": "proven",
    "trackRecordAvgReturnVsBitcoin7dWithoutBestCall": 0.81
  },
  {
    "twitterHandle": "thelearningpill",
    "tweetCount": 29,
    "avgViewsPerTweet": 799.07,
    "avgEngagementPerTweet": 23.55,
    "avgAlpha": 7.21,
    "latestTweetAt": "2026-11-11T10:15:01+00:00",
    "totalReach": 23173,
    "tokensCovered": 19,
    "influenceScore": 0.05,
    "trackRecordSignals": 131,
    "trackRecordUniqueTokens": 52,
    "trackRecordActiveDays": 99,
    "trackRecordCorrect24h": 59,
    "trackRecordOutcomes24h": 126,
    "trackRecordCorrect7d": 52,
    "trackRecordOutcomes7d": 125,
    "trackRecordCorrect30d": 51,
    "trackRecordOutcomes30d": 109,
    "trackRecordMaturedSignals24h": 131,
    "trackRecordMaturedSignals7d": 128,
    "trackRecordMaturedSignals30d": 111,
    "trackRecordOutcomesVsBitcoin24h": 126,
    "trackRecordWinsVsBitcoin24h": 66,
    "trackRecordOutcomesVsBitcoin7d": 125,
    "trackRecordWinsVsBitcoin7d": 53,
    "trackRecordOutcomesVsBitcoin30d": 109,
    "trackRecordWinsVsBitcoin30d": 50,
    "trackRecordBullishSignals": 128,
    "trackRecordBearishSignals": 3,
    "trackRecordFirstSignalDate": "2025-12-11",
    "trackRecordLastSignalDate": "2026-11-11",
    "trackRecordAvgReturn24h": 0.07,
    "trackRecordAvgReturn7d": 0.54,
    "trackRecordAvgReturn30d": 1.16,
    "trackRecordAvgReturnVsBitcoin24h": 0.22,
    "trackRecordAvgReturnVsBitcoin7d": 1.88,
    "trackRecordAvgReturnVsBitcoin30d": 5.74,
    "trackRecordAvgSentiment": 7.85,
    "trackRecordAvgAlpha": 7.3,
    "trackRecordAccuracy24h": 46.83,
    "trackRecordUnavailable24h": 5,
    "trackRecordCoverage24h": 96.18,
    "trackRecordWinRateVsBitcoin24h": 52.38,
    "trackRecordAccuracy7d": 41.6,
    "trackRecordUnavailable7d": 3,
    "trackRecordCoverage7d": 97.66,
    "trackRecordWinRateVsBitcoin7d": 42.4,
    "trackRecordAccuracy30d": 46.79,
    "trackRecordUnavailable30d": 2,
    "trackRecordCoverage30d": 98.2,
    "trackRecordWinRateVsBitcoin30d": 45.87,
    "trackRecordConservativeAccuracy7d": 33.34,
    "trackRecordPerformanceTier": "unproven",
    "trackRecordAvgReturnVsBitcoin7dWithoutBestCall": 1.21
  }
]

The result collection above is limited to 3 items (limit=3). The top two accounts, cryptopatel and whalefactor, carry a proven Track Record Verdict with over 100 graded 7-day calls versus Bitcoin and coverage above 90%, while thelearningpill is unproven with lower 7-day win and coverage rates.

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 No application/vnd.cambrian.deep42.social-data.influencer-credibility.v4+json
4.1.0 Current Yes application/vnd.cambrian.deep42.social-data.influencer-credibility.v4.1+json
5.0.0 Current No application/vnd.cambrian.deep42.social-data.influencer-credibility.v5+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 default version (4.1.0) is returned.


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 a current and comparison period.
  • /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.