Cambrian Crypto Influencer Credibility Rankings API
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
offsetandlimitfor 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.