Cambrian Crypto Influencer Credibility Rankings API
GET /api/v1/deep42/social-data/influencer-credibility
Crypto Influencer Credibility Rankings
Overview
Returns a ranked array of cryptocurrency influencers combining recent posting activity with historical directional-price track records. Each influencer is scored on qualifying recent tweets (views, engagement, tokens covered) alongside a Bitcoin-relative historical performance verdict built from graded directional calls. Influencers are grouped by track-record quality (proven, unproven, insufficient evidence) and ranked within each group by average return versus Bitcoin.
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 number of qualifying tweets required in the activity window. |
limit |
integer | No | 25 | Maximum number of influencers to return (1–100). |
offset |
integer | No | 0 | Number of ranked influencers to skip before the first returned row. Use with limit to page through the full ranked list; a response with fewer than limit rows is the last page. Rows can move between pages when new data arrives between requests. |
token_focus |
string | No | - | Only include influencers with qualifying recent activity for this token symbol. Treated case-insensitively and normalized to uppercase; applies only to recent eligibility, not the historical track record. |
sort_by |
string | No | return_vs_bitcoin |
Sort metric. Options: return_vs_bitcoin (average direction-adjusted 7-day return vs. Bitcoin), win_rate_vs_bitcoin (percentage of graded calls that beat Bitcoin), accuracy (raw 7-day directional accuracy), conservative_accuracy (sample-size-adjusted Wilson estimate), tweets, engagement, reach, alpha, influence, credibility. |
order |
string | No | desc |
Sort direction (asc or desc). With return_vs_bitcoin and desc, results are grouped proven → unproven → insufficientEvidence, then sorted by return within each group. |
min_alpha |
integer | No | 6 | Minimum alpha score (0–10 scale) applied to recent eligibility tweets and historical directional signals. |
min_outcomes_7d |
integer | No | 100 | Minimum number of graded 7-day calls with both token and Bitcoin prices. Lower values are exploratory; 0 includes accounts without a graded BTC-relative outcome (their BTC-relative metrics are null and sort last). |
time_window |
string | No | 30d |
Recent activity window as a trailing UTC interval (e.g. 24h, 48h, 7d, 30d), capped at 90 days. Used only for recent eligibility; the historical track record remains all-history. |
track_record_required |
boolean | No | - | When true, exclude influencers without a historical track record and apply other legacy track-record filters. |
min_accuracy_30d |
number | No | - | Minimum raw 30-day directional accuracy percentage, applied only when track_record_required=true. |
min_signals |
integer | No | - | Minimum total historical directional signals, applied only when track_record_required=true. |
min_unique_tokens |
integer | No | - | Minimum distinct tokens in the historical track record, applied only when track_record_required=true. |
Response Field Descriptions
| Response Field | Type | Description |
|---|---|---|
twitterHandle |
string | Twitter/X handle without @. |
tweetCount |
integer | Qualifying recent tweet count after min_alpha, token_focus, and time_window filters. |
avgViewsPerTweet |
number | Average views per qualifying recent tweet. |
avgEngagementPerTweet |
number | Average likes, reposts, and replies per qualifying recent tweet. |
avgAlpha |
number | null | Average alpha across qualifying recent tweets. |
latestTweetAt |
string | null | Timestamp of the latest qualifying recent tweet. |
totalReach |
integer | Total views across qualifying recent tweets. |
tokensCovered |
integer | Distinct tokens in qualifying recent tweets. |
influenceScore |
number | Legacy reach-weighted engagement score. |
trackRecordSignals |
integer | null | Historical directional signals, deduplicated to one call per influencer/token/direction/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. |
trackRecordCorrect24h |
integer | Resolved 24-hour outcomes whose price movement matched the call. |
trackRecordOutcomes24h |
integer | Signals with a resolved 24-hour comparison price; denominator for raw 24-hour accuracy. |
trackRecordCorrect7d |
integer | Resolved 7-day outcomes whose price movement matched the call. |
trackRecordOutcomes7d |
integer | Signals with a resolved 7-day comparison price; denominator for raw 7-day accuracy and conservative 7-day accuracy sample size. |
trackRecordCorrect30d |
integer | Resolved 30-day outcomes whose price movement matched the call. |
trackRecordOutcomes30d |
integer | Signals with a resolved 30-day comparison price; denominator for raw 30-day accuracy. |
trackRecordMaturedSignals24h |
integer | Deduplicated calls whose 24-hour target UTC date has been reached and is eligible for grading. |
trackRecordMaturedSignals7d |
integer | Deduplicated calls whose 7-day target UTC date has been reached and is eligible for grading. |
trackRecordMaturedSignals30d |
integer | Deduplicated calls whose 30-day target UTC date has been reached and is eligible for grading. |
trackRecordOutcomesVsBitcoin24h |
integer | Graded 24-hour calls with both token and Bitcoin prices; denominator for the 24-hour win rate vs. Bitcoin. |
trackRecordWinsVsBitcoin24h |
integer | Graded 24-hour calls whose direction-adjusted token return beat Bitcoin. |
trackRecordOutcomesVsBitcoin7d |
integer | Graded 7-day calls with both token and Bitcoin prices; denominator for the 7-day win rate vs. Bitcoin and the evidence count used by min_outcomes_7d. |
trackRecordWinsVsBitcoin7d |
integer | Graded 7-day calls whose direction-adjusted token return beat Bitcoin. |
trackRecordOutcomesVsBitcoin30d |
integer | Graded 30-day calls with both token and Bitcoin prices; denominator for the 30-day win rate vs. Bitcoin. |
trackRecordWinsVsBitcoin30d |
integer | Graded 30-day calls whose direction-adjusted token return beat Bitcoin. |
trackRecordBullishSignals |
integer | null | Historical bullish signal count. |
trackRecordBearishSignals |
integer | null | Historical bearish signal count. |
trackRecordFirstSignalDate |
string | null | Earliest historical signal date. |
trackRecordLastSignalDate |
string | null | Latest historical signal date. |
trackRecordAvgReturn24h |
number | null | Average direction-adjusted 24-hour return percentage. Bullish = (futurePrice − signalPrice) / signalPrice × 100; bearish = the inverse. |
trackRecordAvgReturn7d |
number | null | Average direction-adjusted 7-day return percentage, using the same bullish/bearish formula as the 24-hour return. |
trackRecordAvgReturn30d |
number | null | Average direction-adjusted 30-day return percentage, using the same bullish/bearish formula as the 24-hour return. |
trackRecordAvgReturnVsBitcoin24h |
number | null | Average direction-adjusted 24-hour return relative to Bitcoin, in percentage points. Above 0 means calls beat Bitcoin on average; null when no call is graded. |
trackRecordAvgReturnVsBitcoin7d |
number | null | Average direction-adjusted 7-day return relative to Bitcoin, in percentage points. A relative directional view, not literal portfolio profit; null when no call is graded. |
trackRecordAvgReturnVsBitcoin30d |
number | null | Average direction-adjusted 30-day return relative to Bitcoin, in percentage points; null when no call is graded. |
trackRecordAvgSentiment |
number | null | Average historical signal sentiment on the 0–10 scale. |
trackRecordAvgAlpha |
number | null | Average historical signal alpha on the 0–10 scale. |
trackRecordAccuracy24h |
number | null | Raw 24-hour directional accuracy = correct resolved 24-hour calls / resolved 24-hour outcomes × 100. |
trackRecordUnavailable24h |
integer | Matured 24-hour calls missing either the token or Bitcoin comparison price. Reduces coverage but is not assumed to be a token death. |
trackRecordCoverage24h |
number | null | Percentage of matured 24-hour calls graded against Bitcoin; null when none matured. |
trackRecordWinRateVsBitcoin24h |
number | null | Percentage of graded 24-hour calls that beat Bitcoin; null when no call is graded. |
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. |
trackRecordUnavailable7d |
integer | Matured 7-day calls missing either the token or Bitcoin comparison price. |
trackRecordCoverage7d |
number | null | Percentage of matured 7-day calls graded against Bitcoin. At least 90% is required for a proven verdict; null when none matured. |
trackRecordWinRateVsBitcoin7d |
number | null | 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. |
trackRecordAccuracy30d |
number | null | Raw 30-day directional accuracy = correct resolved 30-day calls / resolved 30-day outcomes × 100. |
trackRecordUnavailable30d |
integer | Matured 30-day calls missing either the token or Bitcoin comparison price. |
trackRecordCoverage30d |
number | null | Percentage of matured 30-day calls graded against Bitcoin; null when none matured. |
trackRecordWinRateVsBitcoin30d |
number | null | Percentage of graded 30-day calls that beat Bitcoin; null when no call is graded. |
trackRecordConservativeAccuracy7d |
number | null | Sample-size-adjusted 7-day directional accuracy (0–100), the lower bound of a 95% Wilson confidence interval. When two influencers share the same raw accuracy, the one with more resolved outcomes gets the higher conservative value. Not raw accuracy or a prediction of the next call: use trackRecordAccuracy7d for the observed percentage and trackRecordCorrect7d / trackRecordOutcomes7d for its evidence. |
trackRecordPerformanceTier |
string | null | Bitcoin-relative quality verdict: proven requires at least 100 graded 7-day calls vs. Bitcoin, 30 active days, 3 tokens, at least 90% coverage, a win rate above 50%, and positive average return vs. Bitcoin (including 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. |
Examples
Top Crypto Influencers by Bitcoin-Relative Performance
Fetches the top-ranked influencers using default sorting (return_vs_bitcoin, descending), which groups accounts into proven, unproven, and insufficient-evidence tiers before ranking by average 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": 127.69,
"avgEngagementPerTweet": 20.15,
"avgAlpha": 7.08,
"latestTweetAt": "2026-09-25T05:00:00+00:00",
"totalReach": 1660,
"tokensCovered": 4,
"influenceScore": 0.01,
"trackRecordSignals": 116,
"trackRecordUniqueTokens": 25,
"trackRecordActiveDays": 91,
"trackRecordCorrect24h": 33,
"trackRecordOutcomes24h": 76,
"trackRecordCorrect7d": 42,
"trackRecordOutcomes7d": 103,
"trackRecordCorrect30d": 40,
"trackRecordOutcomes30d": 101,
"trackRecordMaturedSignals24h": 114,
"trackRecordMaturedSignals7d": 111,
"trackRecordMaturedSignals30d": 110,
"trackRecordOutcomesVsBitcoin24h": 76,
"trackRecordWinsVsBitcoin24h": 34,
"trackRecordOutcomesVsBitcoin7d": 103,
"trackRecordWinsVsBitcoin7d": 55,
"trackRecordOutcomesVsBitcoin30d": 101,
"trackRecordWinsVsBitcoin30d": 49,
"trackRecordBullishSignals": 105,
"trackRecordBearishSignals": 11,
"trackRecordFirstSignalDate": "2025-12-07",
"trackRecordLastSignalDate": "2026-09-25",
"trackRecordAvgReturn24h": -0.04,
"trackRecordAvgReturn7d": 1.72,
"trackRecordAvgReturn30d": -7.54,
"trackRecordAvgReturnVsBitcoin24h": 0.25,
"trackRecordAvgReturnVsBitcoin7d": 3.5,
"trackRecordAvgReturnVsBitcoin30d": -0.87,
"trackRecordAvgSentiment": 7.69,
"trackRecordAvgAlpha": 7.4,
"trackRecordAccuracy24h": 43.42,
"trackRecordUnavailable24h": 38,
"trackRecordCoverage24h": 66.67,
"trackRecordWinRateVsBitcoin24h": 44.74,
"trackRecordAccuracy7d": 40.78,
"trackRecordUnavailable7d": 8,
"trackRecordCoverage7d": 92.79,
"trackRecordWinRateVsBitcoin7d": 53.4,
"trackRecordAccuracy30d": 39.6,
"trackRecordUnavailable30d": 9,
"trackRecordCoverage30d": 91.82,
"trackRecordWinRateVsBitcoin30d": 48.51,
"trackRecordConservativeAccuracy7d": 31.78,
"trackRecordPerformanceTier": "proven"
},
{
"twitterHandle": "deitaone",
"tweetCount": 10,
"avgViewsPerTweet": 84729.6,
"avgEngagementPerTweet": 216.2,
"avgAlpha": 6.6,
"latestTweetAt": "2026-09-17T17:55:55+00:00",
"totalReach": 847296,
"tokensCovered": 6,
"influenceScore": 0.19,
"trackRecordSignals": 206,
"trackRecordUniqueTokens": 47,
"trackRecordActiveDays": 123,
"trackRecordCorrect24h": 42,
"trackRecordOutcomes24h": 77,
"trackRecordCorrect7d": 62,
"trackRecordOutcomes7d": 122,
"trackRecordCorrect30d": 57,
"trackRecordOutcomes30d": 129,
"trackRecordMaturedSignals24h": 206,
"trackRecordMaturedSignals7d": 206,
"trackRecordMaturedSignals30d": 206,
"trackRecordOutcomesVsBitcoin24h": 77,
"trackRecordWinsVsBitcoin24h": 48,
"trackRecordOutcomesVsBitcoin7d": 122,
"trackRecordWinsVsBitcoin7d": 56,
"trackRecordOutcomesVsBitcoin30d": 128,
"trackRecordWinsVsBitcoin30d": 58,
"trackRecordBullishSignals": 156,
"trackRecordBearishSignals": 50,
"trackRecordFirstSignalDate": "2024-09-19",
"trackRecordLastSignalDate": "2026-06-12",
"trackRecordAvgReturn24h": 134.62,
"trackRecordAvgReturn7d": 221.88,
"trackRecordAvgReturn30d": 189.49,
"trackRecordAvgReturnVsBitcoin24h": 134.36,
"trackRecordAvgReturnVsBitcoin7d": 221.1,
"trackRecordAvgReturnVsBitcoin30d": 189.75,
"trackRecordAvgSentiment": 6.48,
"trackRecordAvgAlpha": 7.46,
"trackRecordAccuracy24h": 54.55,
"trackRecordUnavailable24h": 129,
"trackRecordCoverage24h": 37.38,
"trackRecordWinRateVsBitcoin24h": 62.34,
"trackRecordAccuracy7d": 50.82,
"trackRecordUnavailable7d": 84,
"trackRecordCoverage7d": 59.22,
"trackRecordWinRateVsBitcoin7d": 45.9,
"trackRecordAccuracy30d": 44.19,
"trackRecordUnavailable30d": 78,
"trackRecordCoverage30d": 62.14,
"trackRecordWinRateVsBitcoin30d": 45.31,
"trackRecordConservativeAccuracy7d": 42.06,
"trackRecordPerformanceTier": "unproven"
},
{
"twitterHandle": "noteezzy",
"tweetCount": 8,
"avgViewsPerTweet": 9704.38,
"avgEngagementPerTweet": 206.75,
"avgAlpha": 6.63,
"latestTweetAt": "2026-09-17T08:07:42+00:00",
"totalReach": 77635,
"tokensCovered": 5,
"influenceScore": 0.13,
"trackRecordSignals": 211,
"trackRecordUniqueTokens": 127,
"trackRecordActiveDays": 134,
"trackRecordCorrect24h": 44,
"trackRecordOutcomes24h": 104,
"trackRecordCorrect7d": 54,
"trackRecordOutcomes7d": 131,
"trackRecordCorrect30d": 42,
"trackRecordOutcomes30d": 123,
"trackRecordMaturedSignals24h": 211,
"trackRecordMaturedSignals7d": 209,
"trackRecordMaturedSignals30d": 188,
"trackRecordOutcomesVsBitcoin24h": 101,
"trackRecordWinsVsBitcoin24h": 34,
"trackRecordOutcomesVsBitcoin7d": 127,
"trackRecordWinsVsBitcoin7d": 50,
"trackRecordOutcomesVsBitcoin30d": 121,
"trackRecordWinsVsBitcoin30d": 43,
"trackRecordBullishSignals": 211,
"trackRecordBearishSignals": 0,
"trackRecordFirstSignalDate": "2025-05-19",
"trackRecordLastSignalDate": "2026-09-24",
"trackRecordAvgReturn24h": 25.94,
"trackRecordAvgReturn7d": 37.82,
"trackRecordAvgReturn30d": -11.45,
"trackRecordAvgReturnVsBitcoin24h": 26.15,
"trackRecordAvgReturnVsBitcoin7d": 39.1,
"trackRecordAvgReturnVsBitcoin30d": -7.7,
"trackRecordAvgSentiment": 8.28,
"trackRecordAvgAlpha": 6.83,
"trackRecordAccuracy24h": 42.31,
"trackRecordUnavailable24h": 110,
"trackRecordCoverage24h": 47.87,
"trackRecordWinRateVsBitcoin24h": 33.66,
"trackRecordAccuracy7d": 41.22,
"trackRecordUnavailable7d": 82,
"trackRecordCoverage7d": 60.77,
"trackRecordWinRateVsBitcoin7d": 39.37,
"trackRecordAccuracy30d": 34.15,
"trackRecordUnavailable30d": 67,
"trackRecordCoverage30d": 64.36,
"trackRecordWinRateVsBitcoin30d": 35.54,
"trackRecordConservativeAccuracy7d": 33.16,
"trackRecordPerformanceTier": "unproven"
}
]
This example limits results to 3 items. gpaandy carries the proven verdict, so it ranks first despite a smaller reach than the other two accounts, which are both unproven. Within the unproven group, deitaone outranks noteezzy on average 7-day return versus Bitcoin.
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 |
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 equal-length 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.