{"openapi":"3.1.0","servers":[{"url":"https://api.cambrian.org"}],"info":{"description":"The Deep42 Cambrian API provides blockchain intelligence from social-media data. This schema documents the enabled Deep42 social-data endpoints.","title":"Deep42 Cambrian API","version":"1.0.0","x-x402":{"enabled":true,"version":"2.0","facilitator":{"url":"https://facilitator.payai.network","verify_endpoint":"/verify","settle_endpoint":"/settle"},"supported_schemes":[{"scheme":"exact","description":"Transfer exact amount for resource access"}],"supported_networks":["eip155:8453","eip155:84532","eip155:1"],"supported_assets":[{"symbol":"USDC","address":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","network":"eip155:8453"},{"symbol":"USDC","address":"0x036CbD53842c5426634e7929541eC2318f3dCF7e","network":"eip155:84532"}]}},"security":[{"ApiKeyAuth":[]},{"x402Payment":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"description":"API key","in":"header","name":"X-API-KEY","type":"apiKey"},"x402Payment":{"type":"apiKey","in":"header","name":"PAYMENT-SIGNATURE","description":"x402 V2 payment header containing base64-encoded payment payload with EIP-712 signature"},"APIKeyHeader":{"type":"apiKey","in":"header","name":"X-API-KEY"}},"schemas":{"PaymentRequiredResponse":{"type":"object","required":["x402Version","accepts"],"description":"x402 V2 Payment Required response","properties":{"x402Version":{"type":"integer","enum":[2],"description":"x402 protocol version"},"error":{"type":"string","description":"Error message describing why payment is required"},"accepts":{"type":"array","items":{"$ref":"#/components/schemas/AcceptsEntry"},"description":"Array of payment options the server accepts"},"resource":{"$ref":"#/components/schemas/X402Resource"},"extensions":{"type":"object","description":"Protocol extensions (e.g., bazaar)","additionalProperties":true}}},"AcceptsEntry":{"type":"object","required":["scheme","network","amount","payTo","asset"],"description":"x402 V2 payment option","properties":{"scheme":{"type":"string","enum":["exact"],"description":"Payment scheme type"},"network":{"type":"string","description":"Blockchain network identifier (CAIP-2 format, e.g. eip155:8453)"},"amount":{"type":"string","description":"Amount required in smallest unit (e.g. 50000 = $0.05 USDC)"},"asset":{"type":"string","description":"Token contract address","pattern":"^0x[a-fA-F0-9]{40}$"},"payTo":{"type":"string","description":"Recipient wallet address","pattern":"^0x[a-fA-F0-9]{40}$"},"maxTimeoutSeconds":{"type":"integer","description":"Maximum timeout for payment authorization"},"extra":{"type":"object","description":"Additional metadata (e.g. asset name, version)","additionalProperties":true}}},"X402Resource":{"type":"object","description":"Descriptor for the resource being purchased","properties":{"url":{"type":"string","description":"URL of the resource"},"description":{"type":"string","description":"Human-readable description"},"mimeType":{"type":"string","description":"MIME type of the response","default":"application/json"}}},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/deep42/social-data/alpha-tweet-detection":{"get":{"summary":"Detect high-alpha tweets","description":"Feed of tweets detected as having high alpha potential for cryptocurrency investments. Each tweet is scored across four dimensions: sentiment (bullish/bearish direction), alpha (investment insight quality), legitimacy (source reliability), and technical accuracy (correctness of crypto/DeFi claims). AI-generated reasoning explains each score. Version 2 (default) includes author track records with directional prediction accuracy measured at hourly price resolution.","operationId":"detectAlphaTweets","parameters":[{"name":"limit","in":"query","required":false,"description":"Number of tweets to analyze Default: 20","schema":{"type":"integer","default":20,"maximum":300}},{"name":"token_filter","in":"query","required":false,"description":"Filter tweets by specific token symbol for focused alpha analysis","schema":{"type":"string"}},{"name":"start_time","in":"query","required":false,"description":"Start of a fixed time window, in Unix seconds (inclusive). Applies to the post creation time (createdAtTimestamp). Without end_time, the window ends at the time of the request. Available from version 2.1.","schema":{"type":"integer","minimum":0}},{"name":"end_time","in":"query","required":false,"description":"End of a fixed time window, in Unix seconds (exclusive). Applies to the post creation time (createdAtTimestamp). Without start_time, the window starts 48 hours before end_time. Available from version 2.1.","schema":{"type":"integer","minimum":1}}],"responses":{"200":{"description":"Alpha tweet detection results with scoring","content":{"application/json":{"schema":{"type":"array","description":"Direct array of alpha tweets with scores (no wrapper)","items":{"type":"object","properties":{"twitterHandle":{"type":"string","description":"Twitter username of the tweet author"},"tokenSymbol":{"type":"string","description":"Cryptocurrency token symbol mentioned in the tweet (e.g., BTC, ETH, SOL)"},"text":{"type":"string","description":"Full tweet text content"},"createdAtTimestamp":{"type":"integer","description":"Unix timestamp (seconds) when the tweet was originally posted on Twitter. Used as the reference time for price tracking: the token price at this timestamp (rounded to nearest hour) becomes price_at_signal for track record calculations"},"scoredAtTimestamp":{"type":"integer","description":"Unix timestamp (seconds) when the post was scored. Later than createdAtTimestamp. Versions before 2.1 return the time of the request."},"retweetCountAtCollection":{"type":"integer","description":"Retweets at time of collection (point-in-time snapshot, not live-updating)"},"favoriteCountAtCollection":{"type":"integer","description":"Likes at time of collection (point-in-time snapshot, not live-updating)"},"replyCountAtCollection":{"type":"integer","description":"Replies at time of collection (point-in-time snapshot, not live-updating)"},"quoteCountAtCollection":{"type":"integer","description":"Quote tweets at time of collection (point-in-time snapshot, not live-updating)"},"sentiment":{"type":"number","description":"AI-scored sentiment direction. Range 0-10. >=7 = bullish signal, <=3 = bearish signal, 4-6 = neutral. Only bullish/bearish tweets generate price prediction signals for track record tracking"},"alpha":{"type":"number","description":"DeFi alpha investment insight quality. Range 0-10. Measures actionability of the information for investment decisions. Higher = more novel, specific, and tradeable insight"},"legitimacy":{"type":"number","description":"Source and claim legitimacy. Range 0-10. Assesses whether claims come from verified sources, contain factual on-chain references, and avoid misleading narratives"},"technicalAccuracy":{"type":"number","description":"Technical correctness of crypto/DeFi claims. Range 0-10. Evaluates protocol mechanics, yield calculations, smart contract references, and on-chain data accuracy"},"isRecent":{"type":"boolean","description":"Whether the tweet content discusses recent events at the time of scoring","nullable":true},"isVerifiable":{"type":"boolean","description":"Whether the tweet's claims can be independently verified via on-chain data, official sources, or public records","nullable":true},"scoresReasoning":{"type":"string","description":"AI-generated explanation of all score assignments, including specific evidence cited, risk factors identified, and verification status of claims","nullable":true},"tweetUrl":{"type":"string","description":"Direct URL to the original tweet on X/Twitter"},"userTrackRecordSignals":{"type":"integer","description":"Total bullish/bearish signals made by this author across all tokens. Only counts tweets with sentiment >=7 (bullish) or <=3 (bearish) that have price data available","nullable":true},"userTrackRecordUniqueTokens":{"type":"integer","description":"Number of distinct token symbols this author has made signals about","nullable":true},"userTrackRecordActiveDays":{"type":"integer","description":"Number of distinct calendar days this author has made at least one signal","nullable":true},"userTrackRecordFirstSignalDate":{"type":"string","description":"ISO date (YYYY-MM-DD) of this author's earliest tracked signal","nullable":true},"userTrackRecordLastSignalDate":{"type":"string","description":"ISO date (YYYY-MM-DD) of this author's most recent tracked signal","nullable":true},"userTrackRecordAccuracy24h":{"type":"number","description":"24-hour directional prediction accuracy as a percentage (0-100). Methodology: a bullish signal is correct if the token price increased within 24h; bearish if it decreased. Price comparison uses hourly resolution, rounded to the nearest hour from the signal timestamp. Calculated only over signals where 24h price data is available (sample size may differ from total signals)","nullable":true},"userTrackRecordAccuracy7d":{"type":"number","description":"7-day directional prediction accuracy as a percentage (0-100). Same methodology as 24h accuracy but comparing the price 7 days after the signal. Calculated only over signals where 7d price data is available","nullable":true},"userTrackRecordAccuracy30d":{"type":"number","description":"30-day directional prediction accuracy as a percentage (0-100). Same methodology as 24h accuracy but comparing the price 30 days after the signal. Calculated only over signals where 30d price data is available (sample size may be significantly smaller than total signals for recent authors)","nullable":true},"userTrackRecordAvgReturn24h":{"type":"number","description":"Average directional return percentage over 24 hours. For bullish signals: (price_24h - price_at_signal) / price_at_signal * 100. For bearish signals: the inverse. Positive = author's calls are directionally profitable on average","nullable":true},"userTrackRecordAvgReturn7d":{"type":"number","description":"Average directional return percentage over 7 days. Same methodology as 24h returns but over a 7-day window","nullable":true},"userTrackRecordAvgReturn30d":{"type":"number","description":"Average directional return percentage over 30 days. Same methodology as 24h returns but over a 30-day window","nullable":true},"userTrackRecordBullishSignals":{"type":"integer","description":"Number of bullish signals (sentiment >=7) made by this author","nullable":true},"userTrackRecordBearishSignals":{"type":"integer","description":"Number of bearish signals (sentiment <=3) made by this author","nullable":true},"userTrackRecordAvgSentiment":{"type":"number","description":"Author's average sentiment score across all signals. Range 0-10","nullable":true},"userTrackRecordAvgAlpha":{"type":"number","description":"Author's average alpha score across all signals. Range 0-10","nullable":true},"userTrackRecordPerformanceTier":{"type":"string","description":"Performance classification based on 24h prediction accuracy. 'topPerformer' = >=70% accuracy, 'proven' = >=60%, 'unproven' = <60%. Null if no accuracy data available","nullable":true}}}}},"application/vnd.cambrian.deep42.social-data.alpha-tweet-detection.v2.1+json":{"schema":{"type":"array","description":"Direct array of alpha tweets with scores (no wrapper)","items":{"type":"object","properties":{"twitterHandle":{"type":"string","description":"Twitter username of the tweet author"},"tokenSymbol":{"type":"string","description":"Cryptocurrency token symbol mentioned in the tweet (e.g., BTC, ETH, SOL)"},"text":{"type":"string","description":"Full tweet text content"},"createdAtTimestamp":{"type":"integer","description":"Unix timestamp (seconds) when the tweet was originally posted on Twitter. Used as the reference time for price tracking: the token price at this timestamp (rounded to nearest hour) becomes price_at_signal for track record calculations"},"scoredAtTimestamp":{"type":"integer","description":"Unix timestamp (seconds) when the post was scored. Later than createdAtTimestamp. Versions before 2.1 return the time of the request."},"retweetCountAtCollection":{"type":"integer","description":"Retweets at time of collection (point-in-time snapshot, not live-updating)"},"favoriteCountAtCollection":{"type":"integer","description":"Likes at time of collection (point-in-time snapshot, not live-updating)"},"replyCountAtCollection":{"type":"integer","description":"Replies at time of collection (point-in-time snapshot, not live-updating)"},"quoteCountAtCollection":{"type":"integer","description":"Quote tweets at time of collection (point-in-time snapshot, not live-updating)"},"sentiment":{"type":"number","description":"AI-scored sentiment direction. Range 0-10. >=7 = bullish signal, <=3 = bearish signal, 4-6 = neutral. Only bullish/bearish tweets generate price prediction signals for track record tracking"},"alpha":{"type":"number","description":"DeFi alpha investment insight quality. Range 0-10. Measures actionability of the information for investment decisions. Higher = more novel, specific, and tradeable insight"},"legitimacy":{"type":"number","description":"Source and claim legitimacy. Range 0-10. Assesses whether claims come from verified sources, contain factual on-chain references, and avoid misleading narratives"},"technicalAccuracy":{"type":"number","description":"Technical correctness of crypto/DeFi claims. Range 0-10. Evaluates protocol mechanics, yield calculations, smart contract references, and on-chain data accuracy"},"isRecent":{"type":"boolean","description":"Whether the tweet content discusses recent events at the time of scoring","nullable":true},"isVerifiable":{"type":"boolean","description":"Whether the tweet's claims can be independently verified via on-chain data, official sources, or public records","nullable":true},"scoresReasoning":{"type":"string","description":"AI-generated explanation of all score assignments, including specific evidence cited, risk factors identified, and verification status of claims","nullable":true},"tweetUrl":{"type":"string","description":"Direct URL to the original tweet on X/Twitter"},"userTrackRecordSignals":{"type":"integer","description":"Total bullish/bearish signals made by this author across all tokens. Only counts tweets with sentiment >=7 (bullish) or <=3 (bearish) that have price data available","nullable":true},"userTrackRecordUniqueTokens":{"type":"integer","description":"Number of distinct token symbols this author has made signals about","nullable":true},"userTrackRecordActiveDays":{"type":"integer","description":"Number of distinct calendar days this author has made at least one signal","nullable":true},"userTrackRecordFirstSignalDate":{"type":"string","description":"ISO date (YYYY-MM-DD) of this author's earliest tracked signal","nullable":true},"userTrackRecordLastSignalDate":{"type":"string","description":"ISO date (YYYY-MM-DD) of this author's most recent tracked signal","nullable":true},"userTrackRecordAccuracy24h":{"type":"number","description":"24-hour directional prediction accuracy as a percentage (0-100). Methodology: a bullish signal is correct if the token price increased within 24h; bearish if it decreased. Price comparison uses hourly resolution, rounded to the nearest hour from the signal timestamp. Calculated only over signals where 24h price data is available (sample size may differ from total signals)","nullable":true},"userTrackRecordAccuracy7d":{"type":"number","description":"7-day directional prediction accuracy as a percentage (0-100). Same methodology as 24h accuracy but comparing the price 7 days after the signal. Calculated only over signals where 7d price data is available","nullable":true},"userTrackRecordAccuracy30d":{"type":"number","description":"30-day directional prediction accuracy as a percentage (0-100). Same methodology as 24h accuracy but comparing the price 30 days after the signal. Calculated only over signals where 30d price data is available (sample size may be significantly smaller than total signals for recent authors)","nullable":true},"userTrackRecordAvgReturn24h":{"type":"number","description":"Average directional return percentage over 24 hours. For bullish signals: (price_24h - price_at_signal) / price_at_signal * 100. For bearish signals: the inverse. Positive = author's calls are directionally profitable on average","nullable":true},"userTrackRecordAvgReturn7d":{"type":"number","description":"Average directional return percentage over 7 days. Same methodology as 24h returns but over a 7-day window","nullable":true},"userTrackRecordAvgReturn30d":{"type":"number","description":"Average directional return percentage over 30 days. Same methodology as 24h returns but over a 30-day window","nullable":true},"userTrackRecordBullishSignals":{"type":"integer","description":"Number of bullish signals (sentiment >=7) made by this author","nullable":true},"userTrackRecordBearishSignals":{"type":"integer","description":"Number of bearish signals (sentiment <=3) made by this author","nullable":true},"userTrackRecordAvgSentiment":{"type":"number","description":"Author's average sentiment score across all signals. Range 0-10","nullable":true},"userTrackRecordAvgAlpha":{"type":"number","description":"Author's average alpha score across all signals. Range 0-10","nullable":true},"userTrackRecordPerformanceTier":{"type":"string","description":"Performance classification based on 24h prediction accuracy. 'topPerformer' = >=70% accuracy, 'proven' = >=60%, 'unproven' = <60%. Null if no accuracy data available","nullable":true}}}}}},"headers":{"Content-Type":{"description":"Response content type with version information","schema":{"type":"string","example":"application/vnd.cambrian.deep42.social-data.alpha-tweet-detection.v2.1+json"}},"X-API-Version":{"description":"The resolved API version for this endpoint","schema":{"type":"string","example":"v1.0.0"}},"Deprecation":{"description":"Indicates the endpoint version is deprecated (RFC 8594)","schema":{"type":"string","example":"Sun, 31 Dec 2025 23:59:59 GMT"},"required":false},"Sunset":{"description":"When the endpoint version will no longer be available (RFC 8594)","schema":{"type":"string","example":"Sun, 31 Dec 2025 23:59:59 GMT"},"required":false},"X-API-Days-Until-Sunset":{"description":"Number of days until the version is sunset","schema":{"type":"integer","example":25},"required":false},"Link":{"description":"Links to successor version and migration documentation (RFC 8288)","schema":{"type":"string"},"required":false}}},"400":{"description":"Invalid numeric parameter. In v2.1 and later, this status replaces the empty list that earlier versions return."},"402":{"description":"Payment Required - x402 V2 payment needed to access this resource","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 V2 payment requirements","schema":{"type":"string"}},"WWW-Authenticate":{"description":"Authentication scheme","schema":{"type":"string","default":"X402"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequiredResponse"},"example":{"x402Version":2,"accepts":[{"scheme":"exact","network":"eip155:8453","amount":"50000","asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","payTo":"0xYOUR_WALLET_ADDRESS","maxTimeoutSeconds":600,"extra":{"name":"USD Coin","version":"2"}}],"resource":{"url":"https://api.cambrian.org/deep42/social-data/alpha-tweet-detection","description":"Access to /deep42/social-data/alpha-tweet-detection","mimeType":"application/json"}}}}},"406":{"description":"Not Acceptable - Unsupported endpoint version requested","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","example":"UNSUPPORTED_ENDPOINT_VERSION"},"message":{"type":"string"},"endpoint":{"type":"string"},"requested_version":{"type":"string"},"supported_versions":{"type":"array","items":{"type":"string"}},"current_version":{"type":"string"}}}}}}}},"410":{"description":"Gone - Endpoint version has been sunset","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","example":"ENDPOINT_VERSION_SUNSET"},"message":{"type":"string"},"endpoint":{"type":"string"},"sunset_date":{"type":"string","format":"date-time"},"current_version":{"type":"string"},"migration_guide":{"type":"string","format":"uri"}}}}}}}},"503":{"description":"The feed is temporarily unavailable. In v2.1 and later, this status replaces the empty list that earlier versions return."}},"tags":["Social Data","x402-enabled"],"x-rate-weight":3,"x-available-versions":{"versions":[{"version":"3.0.0","state":"current","is_default":false,"released_at":"2026-10-28T23:08:15+00:00","accept_header":"application/vnd.cambrian.deep42.social-data.alpha-tweet-detection.v3+json","becomes_default_at":"2026-11-27T23:08:15+00:00","changelog":["Relevance, sentiment and alpha scores come from a new scoring version. Scores, counts and rankings can differ from earlier versions.","Track records and price correlation are computed from the same scores as the rest of this version.","Includes every 2.1.0 change."]},{"version":"2.1.0","state":"current","is_default":true,"released_at":"2026-09-30T17:31:51+00:00","accept_header":"application/vnd.cambrian.deep42.social-data.alpha-tweet-detection.v2.1+json","becomes_default_at":"2026-11-06T14:11:51+00:00","changelog":["Returns 503 when the feed cannot be read, instead of an empty list.","Returns 400 for an invalid numeric parameter, instead of an empty list.","Returns a legitimacy or technical accuracy score of 0 as 0, instead of 8.","Returns tweets from exactly the last 48 hours, instead of whole calendar days.","`scoredAtTimestamp` is the time the post was scored, instead of the time of the request.","Adds the optional `start_time` and `end_time` parameters, in Unix seconds, to read a fixed window of post times."]},{"version":"2.0.0","state":"current","is_default":false,"released_at":"2025-11-26T00:00:00+00:00","accept_header":"application/vnd.cambrian.deep42.social-data.alpha-tweet-detection.v2+json"},{"version":"1.0.0","state":"current","is_default":false,"released_at":"2024-01-01T00:00:00+00:00","accept_header":"application/vnd.cambrian.deep42.social-data.alpha-tweet-detection.v1+json"}],"default_version":"2.1.0","version_count":4},"x-api-version":"2.1.0","x-x402":{"pricing":{"amount":"50000","currency":"USDC","model":"per_request","description":"Pay 0.05 USDC per request"},"accepts":[{"network":"eip155:8453","asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"},{"network":"eip155:84532","asset":"0x036CbD53842c5426634e7929541eC2318f3dCF7e"}]}}},"/deep42/social-data/influencer-credibility":{"get":{"summary":"Crypto Influencer Credibility Rankings","description":"Returns a direct array of cryptocurrency influencers with recent activity and historical directional-price metrics. Requests without a vendor Accept header use v4. Request v2 with Accept: application/vnd.cambrian.deep42.social-data.influencer-credibility.v2+json. V2 preserves legacy activity-first scoring. The v4 default requires 100 graded 7-day calls versus Bitcoin. It groups proven, then unproven, then insufficientEvidence accounts. It ranks each group by average direction-adjusted 7-day return versus Bitcoin. V3 and later expose raw directional accuracy, a conservative accuracy estimate, graded denominators, missing mature prices, and coverage. Parameters and fields marked for v3 and later are ignored or absent in v2.","operationId":"getInfluencerCredibility","parameters":[{"name":"min_tweets","in":"query","required":false,"description":"Minimum number of qualifying tweets required in the activity window.","schema":{"type":"integer","default":5,"minimum":1,"maximum":100}},{"name":"limit","in":"query","required":false,"description":"Maximum number of influencers to return.","schema":{"type":"integer","default":25,"minimum":1,"maximum":300}},{"name":"offset","in":"query","required":false,"description":"Version 4.1 and later. Number of ranked influencers to skip before the first returned row. The default is 0. Use it 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 two requests.","schema":{"type":"integer","minimum":0},"x-version-support":["4.1.0","5.0.0"]},{"name":"handle","in":"query","required":false,"description":"Version 4.1 and later. X handle of one account, with or without a leading @. The match ignores case. The response contains only that account's row, with the same fields and filters as a ranked request, whatever its rank, limit, or offset. The response is an empty array when the account does not meet the filters. A handle with no posts returns 404.","schema":{"type":"string","pattern":"^@?[A-Za-z0-9_]{1,15}$","examples":["exampleAnalyst","@exampleAnalyst"]},"x-version-support":["4.1.0","5.0.0"]},{"name":"include_calls","in":"query","required":false,"description":"Version 4.1 and later. Set to true with handle to add the account's 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.","schema":{"type":"boolean"},"x-version-support":["4.1.0","5.0.0"]},{"name":"token_focus","in":"query","required":false,"description":"Only include influencers with qualifying recent activity for this token symbol. V3 and later treat it case-insensitively, normalize it to uppercase, and use it only for recent eligibility. The historical track record remains all-token.","schema":{"type":"string","pattern":"^[A-Za-z0-9]{1,10}$","examples":["BTC","sol"]}},{"name":"sort_by","in":"query","required":false,"description":"Sort metric. return_vs_bitcoin is the default and uses average direction-adjusted 7-day return relative to Bitcoin. With descending order, Track Record Verdict is applied first. win_rate_vs_bitcoin is the percentage of graded calls that beat Bitcoin. accuracy is raw 7-day directional accuracy. conservative_accuracy is the sample-size-adjusted Wilson estimate. tweets, alpha, engagement, and reach use the recent activity metric of the same name.","schema":{"type":"string","enum":["return_vs_bitcoin","win_rate_vs_bitcoin","accuracy","conservative_accuracy","tweets","alpha","engagement","reach"],"default":"return_vs_bitcoin"},"x-version-support":["3.0.0","4.0.0","5.0.0"]},{"name":"order","in":"query","required":false,"description":"Sort direction. In v3 and later, return_vs_bitcoin with desc groups proven, unproven, and insufficientEvidence accounts. It then sorts each group by the selected return. Other combinations sort directly by the selected metric.","schema":{"type":"string","enum":["asc","desc"],"default":"desc"}},{"name":"min_alpha","in":"query","required":false,"description":"V3 and later. Minimum alpha score on the 0-10 scale, applied to recent eligibility tweets and historical directional signals.","schema":{"type":"integer","default":6,"minimum":0,"maximum":10},"x-version-support":["3.0.0","4.0.0","5.0.0"]},{"name":"min_outcomes_7d","in":"query","required":false,"description":"V3 and later. Minimum number of graded 7-day calls with both token and Bitcoin prices. The default is 100. Lower values are exploratory; use 0 to include accounts without a graded BTC-relative outcome, whose BTC-relative metrics are null and sort last.","schema":{"type":"integer","default":100,"minimum":0},"x-version-support":["3.0.0","4.0.0","5.0.0"]},{"name":"time_window","in":"query","required":false,"description":"Recent activity window. V2 rounds hour values up to whole days. V3 and later use a positive Nh or Nd value as an exact trailing UTC interval. They cap it at 90 days and use it only for recent eligibility. The historical track record remains all-history.","schema":{"type":"string","default":"30d","pattern":"^[1-9][0-9]*[hd]$","examples":["24h","48h","7d","30d"]}}],"responses":{"200":{"description":"A direct array of influencer rankings with nullable historical track-record metrics.","headers":{"Content-Type":{"description":"Response content type with version information","schema":{"type":"string","example":"application/vnd.cambrian.deep42.social-data.influencer-credibility.v4.1+json"}},"X-API-Version":{"description":"The resolved API version for this endpoint","schema":{"type":"string","example":"v1.0.0"}},"Deprecation":{"description":"Indicates the endpoint version is deprecated (RFC 8594)","schema":{"type":"string","example":"Sun, 31 Dec 2025 23:59:59 GMT"},"required":false},"Sunset":{"description":"When the endpoint version will no longer be available (RFC 8594)","schema":{"type":"string","example":"Sun, 31 Dec 2025 23:59:59 GMT"},"required":false},"X-API-Days-Until-Sunset":{"description":"Number of days until the version is sunset","schema":{"type":"integer","example":25},"required":false},"Link":{"description":"Links to successor version and migration documentation (RFC 8288)","schema":{"type":"string"},"required":false},"X-Total-Count":{"description":"Number of accounts that match the filters, before limit and offset. Paging is complete when the rows returned across all pages reach this number. The ranking is computed on each request, so it can change between pages.","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"type":"array","items":{"type":"object","required":["twitterHandle","influenceScore","avgViewsPerTweet","avgEngagementPerTweet","tokensCovered","totalReach"],"properties":{"twitterHandle":{"type":"string","description":"Twitter/X handle without @."},"influenceScore":{"type":"number","description":"Legacy reach-weighted engagement score."},"avgViewsPerTweet":{"type":"number","description":"Average views per qualifying recent tweet."},"avgEngagementPerTweet":{"type":"number","description":"Average likes, reposts, and replies per qualifying recent tweet."},"tokensCovered":{"type":"integer","description":"Distinct tokens in qualifying recent tweets. In v4.2 and later, tweets without an identified token are not counted."},"totalReach":{"type":"integer","description":"Total views across qualifying recent tweets."},"tweetCount":{"type":"integer","description":"V3 and later. Qualifying recent tweet count after min_alpha, token_focus, and time_window filters.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"avgAlpha":{"type":["number","null"],"description":"V3 and later. Average alpha across qualifying recent tweets; trackRecordAvgAlpha covers historical directional signals.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"latestTweetAt":{"type":["string","null"],"format":"date-time","description":"V3 and later. Timestamp of the latest qualifying recent tweet.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordSignals":{"type":["integer","null"],"description":"Historical directional signals, including calls whose later price outcome is not yet resolved. In v3 and later, these are deduplicated to one call per influencer, token, direction, and UTC day. Bitcoin, wrapped Bitcoin, and common stablecoins are excluded."},"trackRecordUniqueTokens":{"type":["integer","null"],"description":"Distinct tokens in the historical signal record."},"trackRecordActiveDays":{"type":["integer","null"],"description":"Distinct UTC calendar days containing a historical signal."},"trackRecordFirstSignalDate":{"type":["string","null"],"format":"date","description":"Earliest historical signal date."},"trackRecordLastSignalDate":{"type":["string","null"],"format":"date","description":"Latest historical signal date."},"trackRecordAccuracy24h":{"type":["number","null"],"minimum":0,"maximum":100,"title":"Raw 24-Hour Accuracy","description":"Raw 24-hour directional accuracy = correct resolved 24-hour calls / resolved 24-hour outcomes * 100."},"trackRecordAccuracy7d":{"type":["number","null"],"minimum":0,"maximum":100,"title":"Raw 7-Day Accuracy","description":"Directly interpretable raw 7-day directional accuracy = trackRecordCorrect7d / trackRecordOutcomes7d * 100: correct resolved calls divided by resolved 7-day outcomes, times 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."},"trackRecordAccuracy30d":{"type":["number","null"],"minimum":0,"maximum":100,"title":"Raw 30-Day Accuracy","description":"Raw 30-day directional accuracy = correct resolved 30-day calls / resolved 30-day outcomes * 100."},"trackRecordCorrect24h":{"type":"integer","description":"V3 and later. Resolved 24-hour outcomes whose price movement matched the call.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordOutcomes24h":{"type":"integer","description":"V3 and later. Signals with a resolved 24-hour comparison price; the raw 24-hour accuracy denominator.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordCorrect7d":{"type":"integer","title":"Correct 7-Day Calls","description":"V3 and later. Resolved 7-day outcomes whose price movement matched the call.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordOutcomes7d":{"type":"integer","title":"Resolved 7-Day Outcomes","description":"V3 and later. Signals with a resolved 7-day comparison price. This is the denominator for Raw 7-Day Accuracy and the sample size used by Conservative 7-Day Accuracy.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordCorrect30d":{"type":"integer","description":"V3 and later. Resolved 30-day outcomes whose price movement matched the call.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordOutcomes30d":{"type":"integer","description":"V3 and later. Signals with a resolved 30-day comparison price; the raw 30-day accuracy denominator.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordAvgReturn24h":{"type":["number","null"],"description":"Average direction-adjusted 24-hour return percentage. Bullish = (futurePrice - signalPrice) / signalPrice * 100; bearish = -(futurePrice - signalPrice) / signalPrice * 100."},"trackRecordAvgReturn7d":{"type":["number","null"],"title":"Average 7-Day Directional Return","description":"Average direction-adjusted 7-day return percentage. Bullish = (futurePrice - signalPrice) / signalPrice * 100; bearish = -(futurePrice - signalPrice) / signalPrice * 100."},"trackRecordAvgReturn30d":{"type":["number","null"],"description":"Average direction-adjusted 30-day return percentage. Bullish = (futurePrice - signalPrice) / signalPrice * 100; bearish = -(futurePrice - signalPrice) / signalPrice * 100."},"trackRecordMaturedSignals24h":{"type":"integer","minimum":0,"description":"V3 and later. Deduplicated calls whose 24-hour target UTC date has been reached and is eligible for grading.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordUnavailable24h":{"type":"integer","minimum":0,"description":"V3 and later. Matured 24-hour calls missing either the token or Bitcoin comparison price. These reduce coverage but are not assumed to be token deaths.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordCoverage24h":{"type":["number","null"],"minimum":0,"maximum":100,"description":"V3 and later. Percentage of matured 24-hour calls graded against Bitcoin: 100 * trackRecordOutcomesVsBitcoin24h / trackRecordMaturedSignals24h. Null when none matured.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordOutcomesVsBitcoin24h":{"type":"integer","minimum":0,"description":"V3 and later. Graded 24-hour calls with both token and Bitcoin prices; denominator for trackRecordWinRateVsBitcoin24h.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordWinsVsBitcoin24h":{"type":"integer","minimum":0,"description":"V3 and later. Graded 24-hour calls whose direction-adjusted token return beat Bitcoin.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordWinRateVsBitcoin24h":{"type":["number","null"],"minimum":0,"maximum":100,"title":"24-Hour Win Rate vs Bitcoin","description":"V3 and later. Percentage of graded 24-hour calls that beat Bitcoin: 100 * wins / graded calls. Null when no call is graded.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordAvgReturnVsBitcoin24h":{"type":["number","null"],"title":"Average 24-Hour Return vs Bitcoin","description":"V3 and later. Average direction-adjusted 24-hour return relative to Bitcoin, in percentage points. Bullish = token return - Bitcoin return; bearish = Bitcoin return - token return. Above 0 means calls beat Bitcoin on average. Bitcoin uses UTC-date prices; null when no call is graded.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordMaturedSignals7d":{"type":"integer","minimum":0,"description":"V3 and later. Deduplicated calls whose 7-day target UTC date has been reached and is eligible for grading.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordUnavailable7d":{"type":"integer","minimum":0,"description":"V3 and later. Matured 7-day calls missing either the token or Bitcoin comparison price. These reduce coverage but are not assumed to be token deaths.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordCoverage7d":{"type":["number","null"],"minimum":0,"maximum":100,"description":"V3 and later. 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.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordOutcomesVsBitcoin7d":{"type":"integer","minimum":0,"title":"Graded 7-Day Calls vs Bitcoin","description":"V3 and later. Graded 7-day calls with both token and Bitcoin prices; denominator for trackRecordWinRateVsBitcoin7d and the evidence count used by min_outcomes_7d.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordWinsVsBitcoin7d":{"type":"integer","minimum":0,"title":"7-Day Wins vs Bitcoin","description":"V3 and later. Graded 7-day calls whose direction-adjusted token return beat Bitcoin.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordWinRateVsBitcoin7d":{"type":["number","null"],"minimum":0,"maximum":100,"title":"7-Day Win Rate vs Bitcoin","description":"V3 and later. 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.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordAvgReturnVsBitcoin7d":{"type":["number","null"],"title":"Average 7-Day Return vs Bitcoin","description":"V3 and later. Average direction-adjusted 7-day return relative to Bitcoin, in percentage points. Bullish = token return - Bitcoin return; bearish = Bitcoin return - token return. Above 0 means calls beat Bitcoin on average. Bitcoin uses UTC-date prices. This is a relative directional view, not literal portfolio profit; null when no call is graded.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordAvgReturnVsBitcoin7dWithoutBestCall":{"type":["number","null"],"title":"Average 7-Day Return vs Bitcoin Without Best Call","description":"Average direction-adjusted 7-day return versus Bitcoin, in percentage points, with the account's single best call removed. It is one of the checks for the proven verdict, which requires a value above 0. Null when fewer than two calls are graded.","x-version-support":["4.1.0","5.0.0"]},"calls":{"type":"array","title":"Calls","description":"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.","x-version-support":["4.1.0","5.0.0"],"items":{"type":"object","properties":{"token":{"type":"string","description":"Token symbol of the call."},"direction":{"type":"string","enum":["bullish","bearish"],"description":"Direction of the call."},"callDate":{"type":"string","format":"date","description":"UTC date of the call."},"return24h":{"type":["number","null"],"description":"Direction-adjusted token return after 24 hours, in percent. Null when not yet measured or unavailable."},"return7d":{"type":["number","null"],"description":"Direction-adjusted token return after 7 days, in percent. Null when not yet measured or unavailable."},"return30d":{"type":["number","null"],"description":"Direction-adjusted token return after 30 days, in percent. Null when not yet measured or unavailable."},"returnVsBitcoin24h":{"type":["number","null"],"description":"return24h minus the direction-adjusted Bitcoin return over the same UTC dates, in percentage points. Null when either return is unavailable."},"returnVsBitcoin7d":{"type":["number","null"],"description":"return7d minus the direction-adjusted Bitcoin return over the same UTC dates, in percentage points. Null when either return is unavailable."},"returnVsBitcoin30d":{"type":["number","null"],"description":"return30d minus the direction-adjusted Bitcoin return over the same UTC dates, in percentage points. Null when either return is unavailable."}}}},"trackRecordMaturedSignals30d":{"type":"integer","minimum":0,"description":"V3 and later. Deduplicated calls whose 30-day target UTC date has been reached and is eligible for grading.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordUnavailable30d":{"type":"integer","minimum":0,"description":"V3 and later. Matured 30-day calls missing either the token or Bitcoin comparison price. These reduce coverage but are not assumed to be token deaths.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordCoverage30d":{"type":["number","null"],"minimum":0,"maximum":100,"description":"V3 and later. Percentage of matured 30-day calls graded against Bitcoin: 100 * trackRecordOutcomesVsBitcoin30d / trackRecordMaturedSignals30d. Null when none matured.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordOutcomesVsBitcoin30d":{"type":"integer","minimum":0,"description":"V3 and later. Graded 30-day calls with both token and Bitcoin prices; denominator for trackRecordWinRateVsBitcoin30d.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordWinsVsBitcoin30d":{"type":"integer","minimum":0,"description":"V3 and later. Graded 30-day calls whose direction-adjusted token return beat Bitcoin.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordWinRateVsBitcoin30d":{"type":["number","null"],"minimum":0,"maximum":100,"title":"30-Day Win Rate vs Bitcoin","description":"V3 and later. Percentage of graded 30-day calls that beat Bitcoin: 100 * wins / graded calls. Null when no call is graded.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordAvgReturnVsBitcoin30d":{"type":["number","null"],"title":"Average 30-Day Return vs Bitcoin","description":"V3 and later. Average direction-adjusted 30-day return relative to Bitcoin, in percentage points. Bullish = token return - Bitcoin return; bearish = Bitcoin return - token return. Above 0 means calls beat Bitcoin on average. Bitcoin uses UTC-date prices; null when no call is graded.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordBullishSignals":{"type":["integer","null"],"description":"Historical bullish signal count."},"trackRecordBearishSignals":{"type":["integer","null"],"description":"Historical bearish signal count."},"trackRecordAvgSentiment":{"type":["number","null"],"description":"Average historical signal sentiment on the 0-10 scale."},"trackRecordAvgAlpha":{"type":["number","null"],"description":"Average historical signal alpha on the 0-10 scale."},"trackRecordPerformanceTier":{"type":["string","null"],"title":"Track Record Verdict","enum":["topPerformer","proven","unproven","insufficientEvidence",null],"description":"V2 uses raw 24-hour accuracy: topPerformer >=70%, proven >=60%, otherwise unproven. In v3 and later, this field 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. The leave-one-out value is internal; the other components are returned. In v4.2 and later, trackRecordAvgReturnVsBitcoin7dWithoutBestCall returns this value."},"trackRecordConservativeAccuracy7d":{"type":["number","null"],"minimum":0,"maximum":100,"title":"Conservative 7-Day Accuracy","description":"V3 and later. A cautious, sample-size-adjusted estimate of 7-day directional accuracy, scaled from 0 to 100. It represents the lower end of a 95% confidence interval: when two influencers have the same raw accuracy, the one with more resolved outcomes receives the higher conservative value. This is not raw accuracy, a prediction of the next call, or a return score. Use trackRecordAccuracy7d for the simple observed percentage and trackRecordCorrect7d / trackRecordOutcomes7d for its evidence. Method: the 95% Wilson score lower bound, where p = trackRecordCorrect7d / trackRecordOutcomes7d, n = trackRecordOutcomes7d, z = 1.96, and value = 100 * (p + z^2/(2n) - z*sqrt(p*(1-p)/n + z^2/(4n^2))) / (1 + z^2/n); null when n=0. Example: 18/25 and 180/250 are both 72% raw accuracy, but their conservative values are about 52.4 and 66.1 because the larger sample provides stronger evidence.","x-version-support":["3.0.0","4.0.0","5.0.0"]}}}}},"application/vnd.cambrian.deep42.social-data.influencer-credibility.v4.1+json":{"schema":{"type":"array","items":{"type":"object","required":["twitterHandle","influenceScore","avgViewsPerTweet","avgEngagementPerTweet","tokensCovered","totalReach"],"properties":{"twitterHandle":{"type":"string","description":"Twitter/X handle without @."},"influenceScore":{"type":"number","description":"Legacy reach-weighted engagement score."},"avgViewsPerTweet":{"type":"number","description":"Average views per qualifying recent tweet."},"avgEngagementPerTweet":{"type":"number","description":"Average likes, reposts, and replies per qualifying recent tweet."},"tokensCovered":{"type":"integer","description":"Distinct tokens in qualifying recent tweets. In v4.2 and later, tweets without an identified token are not counted."},"totalReach":{"type":"integer","description":"Total views across qualifying recent tweets."},"tweetCount":{"type":"integer","description":"V3 and later. Qualifying recent tweet count after min_alpha, token_focus, and time_window filters.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"avgAlpha":{"type":["number","null"],"description":"V3 and later. Average alpha across qualifying recent tweets; trackRecordAvgAlpha covers historical directional signals.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"latestTweetAt":{"type":["string","null"],"format":"date-time","description":"V3 and later. Timestamp of the latest qualifying recent tweet.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordSignals":{"type":["integer","null"],"description":"Historical directional signals, including calls whose later price outcome is not yet resolved. In v3 and later, these are deduplicated to one call per influencer, token, direction, and UTC day. Bitcoin, wrapped Bitcoin, and common stablecoins are excluded."},"trackRecordUniqueTokens":{"type":["integer","null"],"description":"Distinct tokens in the historical signal record."},"trackRecordActiveDays":{"type":["integer","null"],"description":"Distinct UTC calendar days containing a historical signal."},"trackRecordFirstSignalDate":{"type":["string","null"],"format":"date","description":"Earliest historical signal date."},"trackRecordLastSignalDate":{"type":["string","null"],"format":"date","description":"Latest historical signal date."},"trackRecordAccuracy24h":{"type":["number","null"],"minimum":0,"maximum":100,"title":"Raw 24-Hour Accuracy","description":"Raw 24-hour directional accuracy = correct resolved 24-hour calls / resolved 24-hour outcomes * 100."},"trackRecordAccuracy7d":{"type":["number","null"],"minimum":0,"maximum":100,"title":"Raw 7-Day Accuracy","description":"Directly interpretable raw 7-day directional accuracy = trackRecordCorrect7d / trackRecordOutcomes7d * 100: correct resolved calls divided by resolved 7-day outcomes, times 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."},"trackRecordAccuracy30d":{"type":["number","null"],"minimum":0,"maximum":100,"title":"Raw 30-Day Accuracy","description":"Raw 30-day directional accuracy = correct resolved 30-day calls / resolved 30-day outcomes * 100."},"trackRecordCorrect24h":{"type":"integer","description":"V3 and later. Resolved 24-hour outcomes whose price movement matched the call.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordOutcomes24h":{"type":"integer","description":"V3 and later. Signals with a resolved 24-hour comparison price; the raw 24-hour accuracy denominator.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordCorrect7d":{"type":"integer","title":"Correct 7-Day Calls","description":"V3 and later. Resolved 7-day outcomes whose price movement matched the call.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordOutcomes7d":{"type":"integer","title":"Resolved 7-Day Outcomes","description":"V3 and later. Signals with a resolved 7-day comparison price. This is the denominator for Raw 7-Day Accuracy and the sample size used by Conservative 7-Day Accuracy.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordCorrect30d":{"type":"integer","description":"V3 and later. Resolved 30-day outcomes whose price movement matched the call.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordOutcomes30d":{"type":"integer","description":"V3 and later. Signals with a resolved 30-day comparison price; the raw 30-day accuracy denominator.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordAvgReturn24h":{"type":["number","null"],"description":"Average direction-adjusted 24-hour return percentage. Bullish = (futurePrice - signalPrice) / signalPrice * 100; bearish = -(futurePrice - signalPrice) / signalPrice * 100."},"trackRecordAvgReturn7d":{"type":["number","null"],"title":"Average 7-Day Directional Return","description":"Average direction-adjusted 7-day return percentage. Bullish = (futurePrice - signalPrice) / signalPrice * 100; bearish = -(futurePrice - signalPrice) / signalPrice * 100."},"trackRecordAvgReturn30d":{"type":["number","null"],"description":"Average direction-adjusted 30-day return percentage. Bullish = (futurePrice - signalPrice) / signalPrice * 100; bearish = -(futurePrice - signalPrice) / signalPrice * 100."},"trackRecordMaturedSignals24h":{"type":"integer","minimum":0,"description":"V3 and later. Deduplicated calls whose 24-hour target UTC date has been reached and is eligible for grading.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordUnavailable24h":{"type":"integer","minimum":0,"description":"V3 and later. Matured 24-hour calls missing either the token or Bitcoin comparison price. These reduce coverage but are not assumed to be token deaths.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordCoverage24h":{"type":["number","null"],"minimum":0,"maximum":100,"description":"V3 and later. Percentage of matured 24-hour calls graded against Bitcoin: 100 * trackRecordOutcomesVsBitcoin24h / trackRecordMaturedSignals24h. Null when none matured.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordOutcomesVsBitcoin24h":{"type":"integer","minimum":0,"description":"V3 and later. Graded 24-hour calls with both token and Bitcoin prices; denominator for trackRecordWinRateVsBitcoin24h.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordWinsVsBitcoin24h":{"type":"integer","minimum":0,"description":"V3 and later. Graded 24-hour calls whose direction-adjusted token return beat Bitcoin.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordWinRateVsBitcoin24h":{"type":["number","null"],"minimum":0,"maximum":100,"title":"24-Hour Win Rate vs Bitcoin","description":"V3 and later. Percentage of graded 24-hour calls that beat Bitcoin: 100 * wins / graded calls. Null when no call is graded.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordAvgReturnVsBitcoin24h":{"type":["number","null"],"title":"Average 24-Hour Return vs Bitcoin","description":"V3 and later. Average direction-adjusted 24-hour return relative to Bitcoin, in percentage points. Bullish = token return - Bitcoin return; bearish = Bitcoin return - token return. Above 0 means calls beat Bitcoin on average. Bitcoin uses UTC-date prices; null when no call is graded.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordMaturedSignals7d":{"type":"integer","minimum":0,"description":"V3 and later. Deduplicated calls whose 7-day target UTC date has been reached and is eligible for grading.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordUnavailable7d":{"type":"integer","minimum":0,"description":"V3 and later. Matured 7-day calls missing either the token or Bitcoin comparison price. These reduce coverage but are not assumed to be token deaths.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordCoverage7d":{"type":["number","null"],"minimum":0,"maximum":100,"description":"V3 and later. 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.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordOutcomesVsBitcoin7d":{"type":"integer","minimum":0,"title":"Graded 7-Day Calls vs Bitcoin","description":"V3 and later. Graded 7-day calls with both token and Bitcoin prices; denominator for trackRecordWinRateVsBitcoin7d and the evidence count used by min_outcomes_7d.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordWinsVsBitcoin7d":{"type":"integer","minimum":0,"title":"7-Day Wins vs Bitcoin","description":"V3 and later. Graded 7-day calls whose direction-adjusted token return beat Bitcoin.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordWinRateVsBitcoin7d":{"type":["number","null"],"minimum":0,"maximum":100,"title":"7-Day Win Rate vs Bitcoin","description":"V3 and later. 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.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordAvgReturnVsBitcoin7d":{"type":["number","null"],"title":"Average 7-Day Return vs Bitcoin","description":"V3 and later. Average direction-adjusted 7-day return relative to Bitcoin, in percentage points. Bullish = token return - Bitcoin return; bearish = Bitcoin return - token return. Above 0 means calls beat Bitcoin on average. Bitcoin uses UTC-date prices. This is a relative directional view, not literal portfolio profit; null when no call is graded.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordAvgReturnVsBitcoin7dWithoutBestCall":{"type":["number","null"],"title":"Average 7-Day Return vs Bitcoin Without Best Call","description":"Average direction-adjusted 7-day return versus Bitcoin, in percentage points, with the account's single best call removed. It is one of the checks for the proven verdict, which requires a value above 0. Null when fewer than two calls are graded.","x-version-support":["4.1.0","5.0.0"]},"calls":{"type":"array","title":"Calls","description":"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.","x-version-support":["4.1.0","5.0.0"],"items":{"type":"object","properties":{"token":{"type":"string","description":"Token symbol of the call."},"direction":{"type":"string","enum":["bullish","bearish"],"description":"Direction of the call."},"callDate":{"type":"string","format":"date","description":"UTC date of the call."},"return24h":{"type":["number","null"],"description":"Direction-adjusted token return after 24 hours, in percent. Null when not yet measured or unavailable."},"return7d":{"type":["number","null"],"description":"Direction-adjusted token return after 7 days, in percent. Null when not yet measured or unavailable."},"return30d":{"type":["number","null"],"description":"Direction-adjusted token return after 30 days, in percent. Null when not yet measured or unavailable."},"returnVsBitcoin24h":{"type":["number","null"],"description":"return24h minus the direction-adjusted Bitcoin return over the same UTC dates, in percentage points. Null when either return is unavailable."},"returnVsBitcoin7d":{"type":["number","null"],"description":"return7d minus the direction-adjusted Bitcoin return over the same UTC dates, in percentage points. Null when either return is unavailable."},"returnVsBitcoin30d":{"type":["number","null"],"description":"return30d minus the direction-adjusted Bitcoin return over the same UTC dates, in percentage points. Null when either return is unavailable."}}}},"trackRecordMaturedSignals30d":{"type":"integer","minimum":0,"description":"V3 and later. Deduplicated calls whose 30-day target UTC date has been reached and is eligible for grading.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordUnavailable30d":{"type":"integer","minimum":0,"description":"V3 and later. Matured 30-day calls missing either the token or Bitcoin comparison price. These reduce coverage but are not assumed to be token deaths.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordCoverage30d":{"type":["number","null"],"minimum":0,"maximum":100,"description":"V3 and later. Percentage of matured 30-day calls graded against Bitcoin: 100 * trackRecordOutcomesVsBitcoin30d / trackRecordMaturedSignals30d. Null when none matured.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordOutcomesVsBitcoin30d":{"type":"integer","minimum":0,"description":"V3 and later. Graded 30-day calls with both token and Bitcoin prices; denominator for trackRecordWinRateVsBitcoin30d.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordWinsVsBitcoin30d":{"type":"integer","minimum":0,"description":"V3 and later. Graded 30-day calls whose direction-adjusted token return beat Bitcoin.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordWinRateVsBitcoin30d":{"type":["number","null"],"minimum":0,"maximum":100,"title":"30-Day Win Rate vs Bitcoin","description":"V3 and later. Percentage of graded 30-day calls that beat Bitcoin: 100 * wins / graded calls. Null when no call is graded.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordAvgReturnVsBitcoin30d":{"type":["number","null"],"title":"Average 30-Day Return vs Bitcoin","description":"V3 and later. Average direction-adjusted 30-day return relative to Bitcoin, in percentage points. Bullish = token return - Bitcoin return; bearish = Bitcoin return - token return. Above 0 means calls beat Bitcoin on average. Bitcoin uses UTC-date prices; null when no call is graded.","x-version-support":["3.0.0","4.0.0","5.0.0"]},"trackRecordBullishSignals":{"type":["integer","null"],"description":"Historical bullish signal count."},"trackRecordBearishSignals":{"type":["integer","null"],"description":"Historical bearish signal count."},"trackRecordAvgSentiment":{"type":["number","null"],"description":"Average historical signal sentiment on the 0-10 scale."},"trackRecordAvgAlpha":{"type":["number","null"],"description":"Average historical signal alpha on the 0-10 scale."},"trackRecordPerformanceTier":{"type":["string","null"],"title":"Track Record Verdict","enum":["topPerformer","proven","unproven","insufficientEvidence",null],"description":"V2 uses raw 24-hour accuracy: topPerformer >=70%, proven >=60%, otherwise unproven. In v3 and later, this field 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. The leave-one-out value is internal; the other components are returned. In v4.2 and later, trackRecordAvgReturnVsBitcoin7dWithoutBestCall returns this value."},"trackRecordConservativeAccuracy7d":{"type":["number","null"],"minimum":0,"maximum":100,"title":"Conservative 7-Day Accuracy","description":"V3 and later. A cautious, sample-size-adjusted estimate of 7-day directional accuracy, scaled from 0 to 100. It represents the lower end of a 95% confidence interval: when two influencers have the same raw accuracy, the one with more resolved outcomes receives the higher conservative value. This is not raw accuracy, a prediction of the next call, or a return score. Use trackRecordAccuracy7d for the simple observed percentage and trackRecordCorrect7d / trackRecordOutcomes7d for its evidence. Method: the 95% Wilson score lower bound, where p = trackRecordCorrect7d / trackRecordOutcomes7d, n = trackRecordOutcomes7d, z = 1.96, and value = 100 * (p + z^2/(2n) - z*sqrt(p*(1-p)/n + z^2/(4n^2))) / (1 + z^2/n); null when n=0. Example: 18/25 and 180/250 are both 72% raw accuracy, but their conservative values are about 52.4 and 66.1 because the larger sample provides stronger evidence.","x-version-support":["3.0.0","4.0.0","5.0.0"]}}}}}}},"400":{"description":"Invalid query parameters."},"404":{"description":"Version 4.1 and later. No posts were found for the requested handle."},"406":{"description":"Not Acceptable - Unsupported endpoint version requested","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","example":"UNSUPPORTED_ENDPOINT_VERSION"},"message":{"type":"string"},"endpoint":{"type":"string"},"requested_version":{"type":"string"},"supported_versions":{"type":"array","items":{"type":"string"}},"current_version":{"type":"string"}}}}}}}},"410":{"description":"Gone - Endpoint version has been sunset","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","example":"ENDPOINT_VERSION_SUNSET"},"message":{"type":"string"},"endpoint":{"type":"string"},"sunset_date":{"type":"string","format":"date-time"},"current_version":{"type":"string"},"migration_guide":{"type":"string","format":"uri"}}}}}}}},"500":{"description":"V2 internal server error."},"503":{"description":"Influencer credibility data is temporarily unavailable; query failure is never returned as an empty successful leaderboard."}},"tags":["Social Data","Influencers"],"x-rate-weight":2,"x-request-examples":[{"name":"V3 BTC-relative track record","accept":"application/vnd.cambrian.deep42.social-data.influencer-credibility.v3+json","query":"sort_by=return_vs_bitcoin&limit=25"},{"name":"V3 win rate versus Bitcoin","accept":"application/vnd.cambrian.deep42.social-data.influencer-credibility.v3+json","query":"sort_by=win_rate_vs_bitcoin&limit=25"},{"name":"V3 conservative 7-day accuracy","accept":"application/vnd.cambrian.deep42.social-data.influencer-credibility.v3+json","query":"sort_by=conservative_accuracy&limit=25"},{"name":"V3 exploratory smaller samples","accept":"application/vnd.cambrian.deep42.social-data.influencer-credibility.v3+json","query":"min_outcomes_7d=25&sort_by=conservative_accuracy"},{"name":"V3 recently active SOL influencers","accept":"application/vnd.cambrian.deep42.social-data.influencer-credibility.v3+json","query":"time_window=48h&sort_by=return_vs_bitcoin&token_focus=<TOKEN_SYMBOL>"}],"x-available-versions":{"versions":[{"version":"5.0.0","state":"current","is_default":false,"released_at":"2026-10-28T23:08:15+00:00","accept_header":"application/vnd.cambrian.deep42.social-data.influencer-credibility.v5+json","becomes_default_at":"2026-11-27T23:08:15+00:00","changelog":["Relevance, sentiment and alpha scores come from a new scoring version. Scores, counts and rankings can differ from earlier versions.","Track records and price correlation are computed from the same scores as the rest of this version.","Includes every 4.1.0 change."]},{"version":"4.1.0","state":"current","is_default":true,"released_at":"2026-09-25T00:00:00+00:00","accept_header":"application/vnd.cambrian.deep42.social-data.influencer-credibility.v4.1+json","becomes_default_at":"2026-11-06T14:08:47+00:00","changelog":["Adds `offset` to page through the full ranked list.","`tokensCovered` counts only identified tokens.","Adds `trackRecordAvgReturnVsBitcoin7dWithoutBestCall`, the proven-tier check that removes the account's single best call.","Adds `handle` to return one account's row, whatever its rank.","Adds `include_calls`. With `handle`, the row lists the account's calls in `calls`, so each track-record total can be checked call by call.","Returns 404 for a `handle` that has no posts, instead of an empty list. A known account that does not meet the filters still returns an empty list.","24-hour and 30-day track-record metrics use the same call checks as the 7-day metrics."]},{"version":"4.0.0","state":"current","is_default":false,"released_at":"2026-09-02T00:00:00+00:00","accept_header":"application/vnd.cambrian.deep42.social-data.influencer-credibility.v4+json","becomes_default_at":"2026-09-08T00:00:00+00:00"},{"version":"3.0.0","state":"current","is_default":false,"released_at":"2026-08-20T00:00:00+00:00","accept_header":"application/vnd.cambrian.deep42.social-data.influencer-credibility.v3+json"},{"version":"2.0.0","state":"current","is_default":false,"released_at":"2025-11-26T00:00:00+00:00","accept_header":"application/vnd.cambrian.deep42.social-data.influencer-credibility.v2+json"},{"version":"1.0.0","state":"current","is_default":false,"released_at":"2024-01-01T00:00:00+00:00","accept_header":"application/vnd.cambrian.deep42.social-data.influencer-credibility.v1+json"}],"default_version":"4.1.0","version_count":6},"x-api-version":"4.1.0","security":[{"ApiKeyAuth":[]}]}},"/deep42/social-data/sentiment-shifts":{"get":{"summary":"Detect major sentiment shifts in crypto tokens","description":"Identifies tokens with significant sentiment changes that could signal market movements and trading opportunities. Compares average AI-assigned sentiment scores (0-10 per tweet) between the current period (the last 24 hours) and a previous period that comparison_period sets. In v2.1 and later, the two periods have equal length: the last comparison_period and the comparison_period before it, in rolling UTC hours. Only includes tokens with sufficient tweet volume in both periods for statistical relevance.","operationId":"getSentimentShifts","parameters":[{"name":"comparison_period","in":"query","required":false,"description":"Length of the comparison. The current period is the last 24 hours. The previous period runs from comparison_period ago to 24 hours ago; for 24h, it is the 24 hours before the current period. In v2.1 and later, the current period is the last comparison_period and the previous period is the comparison_period before it, in rolling UTC hours (3d: the last 72 hours and the 72 hours before them). Before v3, any other value is treated as 3d. In v3 and later, any other value returns 400.","schema":{"type":"string","enum":["24h","3d","7d"],"default":"3d"}},{"name":"limit","in":"query","required":false,"description":"Number of tokens to return","schema":{"type":"integer","default":20,"maximum":300}}],"responses":{"200":{"description":"Tokens with significant sentiment shifts","content":{"application/json":{"schema":{"type":"array","description":"Direct array of tokens with sentiment shifts (no wrapper)","items":{"type":"object","properties":{"tokenSymbol":{"type":"string","description":"Cryptocurrency token symbol (e.g., BTC, ETH, SOL)"},"sentimentShift":{"type":"number","description":"Change in average sentiment between current and previous period. Calculated as currentSentiment - previousSentiment. Range: -10 to +10. Positive = bullish shift, negative = bearish shift. >2 = notable, >5 = major shift"},"currentSentiment":{"type":"number","description":"Average AI-assigned sentiment score across all tweets about this token in the current period (last 24 hours). Range 0-10. Each tweet is independently scored: 0 = very bearish, 5 = neutral, 10 = very bullish. Minimum 3 tweets required. In v2.1 and later, the current period is the last comparison_period."},"previousSentiment":{"type":"number","description":"Average AI-assigned sentiment score across all tweets in the previous period (from comparison_period ago to 24h ago; for 24h, from 48h ago to 24h ago). Range 0-10. Minimum 2 tweets required. In v2.1 and later, the previous period is the comparison_period before the current period, and an average of 0 is returned as 0."},"currentPeriodTweets":{"type":"integer","description":"Number of tweets about this token in the current period (last 24 hours). Higher counts indicate more active discussion and more reliable sentiment averages. In v2.1 and later, the current period is the last comparison_period."},"previousPeriodTweets":{"type":"integer","description":"Number of tweets about this token in the previous period. Used as denominator for volumeChange calculation"},"currentPeriodAuthors":{"type":"integer","description":"Number of distinct authors discussing this token in the current period. Higher counts indicate broader market attention rather than a single voice driving sentiment"},"bullishRatio":{"type":"number","description":"Percentage of current-period tweets with bullish sentiment (score >=6). Range 0-100. >60 = bullish majority, <40 = bearish majority. Calculated from tweets scoring >=6 (bullish) vs <4 (bearish), excluding neutral 4-5"},"volumeChange":{"type":"number","description":"Ratio of current period tweet count to previous period. 1.0 = unchanged, 2.0 = doubled, 0.5 = halved. >1.5 = significant increase in discussion volume"},"qualityScore":{"type":"number","description":"Sum of average sentiment + average alpha for current period tweets. Range 0-20. Indicates both directional conviction and content quality. >10 = above-average, >15 = high quality"},"volatility":{"type":"number","description":"Standard deviation of sentiment scores within the current period. Range 0-5. <1 = strong consensus among authors, >2 = highly divided opinions"},"confidenceScore":{"type":"number","description":"Confidence in the detected shift. Calculated as log(tweet_count + 1) * abs(sentiment_shift). Accounts for both sample size and shift magnitude. Higher = more reliable signal. >3 = moderate confidence, >5 = high confidence"},"signalMagnitude":{"type":"number","description":"Shift magnitude normalized by volatility. Calculated as abs(sentiment_shift) / max(volatility, 1). >1 = shift exceeds normal variance, >2 = shift is 2x normal variance. Higher values indicate more statistically meaningful shifts"}}}}},"application/vnd.cambrian.deep42.social-data.sentiment-shifts.v2.1+json":{"schema":{"type":"array","description":"Direct array of tokens with sentiment shifts (no wrapper)","items":{"type":"object","properties":{"tokenSymbol":{"type":"string","description":"Cryptocurrency token symbol (e.g., BTC, ETH, SOL)"},"sentimentShift":{"type":"number","description":"Change in average sentiment between current and previous period. Calculated as currentSentiment - previousSentiment. Range: -10 to +10. Positive = bullish shift, negative = bearish shift. >2 = notable, >5 = major shift"},"currentSentiment":{"type":"number","description":"Average AI-assigned sentiment score across all tweets about this token in the current period (last 24 hours). Range 0-10. Each tweet is independently scored: 0 = very bearish, 5 = neutral, 10 = very bullish. Minimum 3 tweets required. In v2.1 and later, the current period is the last comparison_period."},"previousSentiment":{"type":"number","description":"Average AI-assigned sentiment score across all tweets in the previous period (from comparison_period ago to 24h ago; for 24h, from 48h ago to 24h ago). Range 0-10. Minimum 2 tweets required. In v2.1 and later, the previous period is the comparison_period before the current period, and an average of 0 is returned as 0."},"currentPeriodTweets":{"type":"integer","description":"Number of tweets about this token in the current period (last 24 hours). Higher counts indicate more active discussion and more reliable sentiment averages. In v2.1 and later, the current period is the last comparison_period."},"previousPeriodTweets":{"type":"integer","description":"Number of tweets about this token in the previous period. Used as denominator for volumeChange calculation"},"currentPeriodAuthors":{"type":"integer","description":"Number of distinct authors discussing this token in the current period. Higher counts indicate broader market attention rather than a single voice driving sentiment"},"bullishRatio":{"type":"number","description":"Percentage of current-period tweets with bullish sentiment (score >=6). Range 0-100. >60 = bullish majority, <40 = bearish majority. Calculated from tweets scoring >=6 (bullish) vs <4 (bearish), excluding neutral 4-5"},"volumeChange":{"type":"number","description":"Ratio of current period tweet count to previous period. 1.0 = unchanged, 2.0 = doubled, 0.5 = halved. >1.5 = significant increase in discussion volume"},"qualityScore":{"type":"number","description":"Sum of average sentiment + average alpha for current period tweets. Range 0-20. Indicates both directional conviction and content quality. >10 = above-average, >15 = high quality"},"volatility":{"type":"number","description":"Standard deviation of sentiment scores within the current period. Range 0-5. <1 = strong consensus among authors, >2 = highly divided opinions"},"confidenceScore":{"type":"number","description":"Confidence in the detected shift. Calculated as log(tweet_count + 1) * abs(sentiment_shift). Accounts for both sample size and shift magnitude. Higher = more reliable signal. >3 = moderate confidence, >5 = high confidence"},"signalMagnitude":{"type":"number","description":"Shift magnitude normalized by volatility. Calculated as abs(sentiment_shift) / max(volatility, 1). >1 = shift exceeds normal variance, >2 = shift is 2x normal variance. Higher values indicate more statistically meaningful shifts"}}}}}},"headers":{"Content-Type":{"description":"Response content type with version information","schema":{"type":"string","example":"application/vnd.cambrian.deep42.social-data.sentiment-shifts.v2.1+json"}},"X-API-Version":{"description":"The resolved API version for this endpoint","schema":{"type":"string","example":"v1.0.0"}},"Deprecation":{"description":"Indicates the endpoint version is deprecated (RFC 8594)","schema":{"type":"string","example":"Sun, 31 Dec 2025 23:59:59 GMT"},"required":false},"Sunset":{"description":"When the endpoint version will no longer be available (RFC 8594)","schema":{"type":"string","example":"Sun, 31 Dec 2025 23:59:59 GMT"},"required":false},"X-API-Days-Until-Sunset":{"description":"Number of days until the version is sunset","schema":{"type":"integer","example":25},"required":false},"Link":{"description":"Links to successor version and migration documentation (RFC 8288)","schema":{"type":"string"},"required":false}}},"402":{"description":"Payment Required - x402 V2 payment needed to access this resource","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 V2 payment requirements","schema":{"type":"string"}},"WWW-Authenticate":{"description":"Authentication scheme","schema":{"type":"string","default":"X402"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequiredResponse"},"example":{"x402Version":2,"accepts":[{"scheme":"exact","network":"eip155:8453","amount":"50000","asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","payTo":"0xYOUR_WALLET_ADDRESS","maxTimeoutSeconds":600,"extra":{"name":"USD Coin","version":"2"}}],"resource":{"url":"https://api.cambrian.org/deep42/social-data/sentiment-shifts","description":"Access to /deep42/social-data/sentiment-shifts","mimeType":"application/json"}}}}},"406":{"description":"Not Acceptable - Unsupported endpoint version requested","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","example":"UNSUPPORTED_ENDPOINT_VERSION"},"message":{"type":"string"},"endpoint":{"type":"string"},"requested_version":{"type":"string"},"supported_versions":{"type":"array","items":{"type":"string"}},"current_version":{"type":"string"}}}}}}}},"410":{"description":"Gone - Endpoint version has been sunset","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","example":"ENDPOINT_VERSION_SUNSET"},"message":{"type":"string"},"endpoint":{"type":"string"},"sunset_date":{"type":"string","format":"date-time"},"current_version":{"type":"string"},"migration_guide":{"type":"string","format":"uri"}}}}}}}}},"tags":["Social Data","x402-enabled"],"x-rate-weight":2,"x-available-versions":{"versions":[{"version":"3.0.0","state":"current","is_default":false,"released_at":"2026-10-28T23:08:15+00:00","accept_header":"application/vnd.cambrian.deep42.social-data.sentiment-shifts.v3+json","becomes_default_at":"2026-11-27T23:08:15+00:00","changelog":["Relevance, sentiment and alpha scores come from a new scoring version. Scores, counts and rankings can differ from earlier versions.","Returns 400 for a `comparison_period` other than 24h, 3d or 7d. Earlier versions treat it as 3d.","Includes every 2.1.0 change."]},{"version":"2.1.0","state":"current","is_default":true,"released_at":"2026-09-30T18:12:58+00:00","accept_header":"application/vnd.cambrian.deep42.social-data.sentiment-shifts.v2.1+json","becomes_default_at":"2026-10-30T18:12:58+00:00","changelog":["Compares two equal rolling UTC periods: the last `comparison_period` and the `comparison_period` before it.","Returns a `previousSentiment` of 0 as 0, instead of 5."]},{"version":"2.0.0","state":"current","is_default":false,"released_at":"2026-09-02T00:00:00+00:00","accept_header":"application/vnd.cambrian.deep42.social-data.sentiment-shifts.v2+json","becomes_default_at":"2026-09-08T00:00:00+00:00"},{"version":"1.0.0","state":"current","is_default":false,"released_at":"2024-01-01T00:00:00+00:00","accept_header":"application/vnd.cambrian.deep42.social-data.sentiment-shifts.v1+json"}],"default_version":"2.1.0","version_count":4},"x-api-version":"2.1.0","x-x402":{"pricing":{"amount":"50000","currency":"USDC","model":"per_request","description":"Pay 0.05 USDC per request"},"accepts":[{"network":"eip155:8453","asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"},{"network":"eip155:84532","asset":"0x036CbD53842c5426634e7929541eC2318f3dCF7e"}]}}},"/deep42/social-data/token-analysis":{"get":{"summary":"Deep social analysis for a specific token","description":"Comprehensive social intelligence report for a cryptocurrency token with sentiment analysis.","operationId":"getTokenSocialAnalysis","parameters":[{"name":"token_symbol","in":"query","required":false,"description":"Token symbol to analyze (e.g. BTC, ETH, SOL). Defaults to SOL when omitted; in that case the response includes tokenSymbolDefaulted=true.","schema":{"type":"string","examples":{"major_crypto":{"value":"BTC","summary":"Bitcoin analysis"},"ethereum":{"value":"ETH","summary":"Ethereum social metrics"},"solana":{"value":"SOL","summary":"Solana ecosystem analysis"},"popular_altcoin":{"value":"HYPE","summary":"Popular altcoin analysis"},"defi_token":{"value":"JUPITER","summary":"DeFi protocol token"}}}},{"name":"days_back","in":"query","required":false,"description":"Number of days of history to analyze. Values are clamped to the range 1 to 730 (out-of-range values are silently clamped to the nearest bound, not rejected). Non-integer values return a 400. In v2.1 and later, the window is exactly the last days_back × 24 hours, in UTC.","schema":{"type":"integer","default":7,"minimum":1,"maximum":730}},{"name":"granularity","in":"query","required":false,"description":"Aggregation granularity. Use 'total' for a single aggregate object, or a fixed bucket width expressed as <N>h (hours) or <N>d (days) for a time series, e.g. 1h, 4h, 6h, 1d, 7d, 30d. Bucket widths from 1h to 365d are supported. Time-series buckets are returned most-recent first, up to 1000.","schema":{"type":"string","default":"total","pattern":"^(total|[1-9][0-9]*[hd])$","examples":{"aggregate":{"value":"total","summary":"Single aggregate object"},"hourly":{"value":"1h","summary":"Hourly buckets"},"four_hour":{"value":"4h","summary":"4-hour buckets"},"daily":{"value":"1d","summary":"Daily buckets"},"weekly":{"value":"7d","summary":"7-day buckets"}}}}],"responses":{"200":{"description":"Token social analysis. For granularity='total', returns a single aggregate object that also reports sentiment-to-price correlation: how bullish and bearish sentiment aligned with subsequent price movements at the 1d, 7d, and 30d horizons over a fixed trailing 90-day window (per-horizon values are null where price history is insufficient). The price-correlation metrics are computed over a fixed trailing 90-day window and are independent of days_back; the priceCorrelation*Signals counts reflect that window and are therefore not directly comparable to totalTweets, which counts tweets in the requested period. Time-based granularities return a wrapper object with a `timeseries` array (most-recent first, capped at a fixed row limit; `truncated` flags when older buckets were dropped). Tokens with insufficient social coverage (or no data) return an insufficient-data object.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","description":"Insufficient-data response. Returned when the token has fewer than 10 tweets or fewer than 3 distinct authors in the requested window, so no statistically meaningful analysis is produced. Retry with a larger days_back.","properties":{"tokenSymbol":{"type":"string","description":"Token symbol analyzed"},"insufficientData":{"type":"boolean","description":"True when analysis was withheld because the token had insufficient social coverage"},"totalTweets":{"type":"integer","description":"Tweets found in the window (below the minimum of 10)"},"uniqueAuthors":{"type":"integer","description":"Distinct authors found in the window (below the minimum of 3 for the aggregate path; 0 for the time-series path which does not compute global author distinctness)"},"analysisPeriodDays":{"type":"integer","description":"Days looked back"},"message":{"type":"string","description":"Human-readable explanation of why analysis was withheld"},"tokenSymbolDefaulted":{"type":"boolean","description":"True when token_symbol was omitted and the analysis defaulted to SOL"}}},{"type":"object","description":"Single token analysis object (when granularity='total')","properties":{"tokenSymbol":{"type":"string","description":"Token symbol analyzed"},"totalTweets":{"type":"integer","description":"Total high-quality tweets in the analysis period"},"uniqueAuthors":{"type":"integer","description":"Number of unique authors discussing this token"},"avgSentiment":{"type":"number","description":"Average sentiment score. Range 0-10. 0 = very bearish, 5 = neutral, 10 = very bullish"},"avgAlpha":{"type":"number","description":"Average alpha (novelty/actionability) score. Range 0-10. Higher = more novel and actionable insights"},"sentimentVolatility":{"type":"number","description":"Standard deviation of sentiment scores. Range 0-5. <1 = strong consensus, >2 = highly divided opinions"},"totalLikes":{"type":"integer","description":"Total likes across all tweets"},"totalRetweets":{"type":"integer","description":"Total retweets across all tweets"},"totalReplies":{"type":"integer","description":"Total replies across all tweets"},"totalViews":{"type":"integer","description":"Total views across all tweets"},"totalEngagement":{"type":"integer","description":"Total engagement (likes + retweets + replies)"},"engagementRate":{"type":"number","description":"Engagement as a percentage of views: (likes + retweets + replies) / views * 100. Typically 0-100; values above ~5 indicate above-average engagement"},"avgLikesPerTweet":{"type":"number","description":"Average likes per tweet"},"avgRetweetsPerTweet":{"type":"number","description":"Average retweets per tweet"},"veryBullishTweets":{"type":"integer","description":"Count of tweets with sentiment >= 8"},"bullishTweets":{"type":"integer","description":"Count of tweets with sentiment 6-7.9"},"neutralTweets":{"type":"integer","description":"Count of tweets with sentiment 4-5.9"},"bearishTweets":{"type":"integer","description":"Count of tweets with sentiment < 4"},"veryBullishPct":{"type":"number","description":"Percentage of very bullish tweets. Range 0-100"},"bullishPct":{"type":"number","description":"Percentage of bullish tweets. Range 0-100"},"neutralPct":{"type":"number","description":"Percentage of neutral tweets. Range 0-100"},"bearishPct":{"type":"number","description":"Percentage of bearish tweets. Range 0-100"},"firstTweet":{"type":"string","description":"Timestamp of earliest tweet in the period"},"latestTweet":{"type":"string","description":"Timestamp of most recent tweet in the period"},"activeDays":{"type":"integer","description":"Number of days with at least one tweet. In v2.1 and later, days are UTC dates, so a window of N days can touch N + 1 dates."},"analysisPeriodDays":{"type":"integer","description":"Total days covered by the analysis"},"tokenSymbolDefaulted":{"type":"boolean","description":"True when token_symbol was omitted and the analysis defaulted to SOL"},"priceCorrelationBullishAccuracy24h":{"type":"number","description":"Percentage of bullish signals followed by a price increase after 24 hours. Null when price history at this horizon is insufficient."},"priceCorrelationBullishAccuracy7d":{"type":"number","description":"% of bullish signals where price increased after 7 days"},"priceCorrelationBullishAccuracy30d":{"type":"number","description":"% of bullish signals where price increased after 30 days"},"priceCorrelationBearishAccuracy24h":{"type":"number","description":"% of bearish signals where price decreased after 24 hours"},"priceCorrelationBearishAccuracy7d":{"type":"number","description":"% of bearish signals where price decreased after 7 days"},"priceCorrelationBearishAccuracy30d":{"type":"number","description":"% of bearish signals where price decreased after 30 days"},"priceCorrelationBullishAvgReturn24h":{"type":"number","description":"Average % return 24 hours after bullish signal"},"priceCorrelationBullishAvgReturn7d":{"type":"number","description":"Average % return 7 days after bullish signal"},"priceCorrelationBullishAvgReturn30d":{"type":"number","description":"Average % return 30 days after bullish signal"},"priceCorrelationBearishAvgReturn24h":{"type":"number","description":"Average % return 24 hours after bearish signal"},"priceCorrelationBearishAvgReturn7d":{"type":"number","description":"Average % return 7 days after bearish signal"},"priceCorrelationBearishAvgReturn30d":{"type":"number","description":"Average % return 30 days after bearish signal"},"priceCorrelationBullishSignals":{"type":"integer","description":"Total bullish sentiment signals tracked over the trailing 90-day correlation window; not directly comparable to totalTweets, which counts tweets in the requested period"},"priceCorrelationBearishSignals":{"type":"integer","description":"Total bearish sentiment signals tracked over the trailing 90-day correlation window; not directly comparable to totalTweets, which counts tweets in the requested period"},"priceCorrelationEnrichedSignals":{"type":"integer","description":"Signals with completed price data"},"priceCorrelationPendingSignals":{"type":"integer","description":"Signals awaiting price data"},"priceCorrelationFirstSignalDate":{"type":"string","description":"Earliest signal date (YYYY-MM-DD)"},"priceCorrelationLastSignalDate":{"type":"string","description":"Latest signal date (YYYY-MM-DD)"}}},{"type":"object","description":"Time-series response (returned when granularity != 'total'). A wrapper object; the `timeseries` array holds one entry per fixed-width bucket, most-recent first, capped at 1000 buckets.","properties":{"tokenSymbol":{"type":"string","description":"Token symbol analyzed"},"granularity":{"type":"string","description":"Echo of the requested (normalized) granularity, e.g. '6h'"},"analysisPeriodDays":{"type":"integer","description":"Days looked back"},"tokenSymbolDefaulted":{"type":"boolean","description":"True when token_symbol was omitted and the analysis defaulted to SOL"},"bucketCount":{"type":"integer","description":"Number of time buckets returned in this response"},"maxBuckets":{"type":"integer","description":"Maximum buckets returnable in a single response (the row cap)"},"truncated":{"type":"boolean","description":"True when the requested days_back/granularity produced more buckets than the cap and the oldest buckets were dropped. The buckets returned are the most recent ones. Narrow days_back or use a coarser granularity to fit the full range."},"timeseries":{"type":"array","description":"One entry per time bucket (most-recent first, max 1000)","items":{"type":"object","properties":{"timeBucket":{"type":"string","description":"Bucket start timestamp (inclusive), in UTC. Buckets are fixed-width per the requested granularity, e.g. '2026-06-05 00:00:00+00'"},"tweetsCount":{"type":"integer","description":"High-quality tweets in this bucket"},"uniqueAuthors":{"type":"integer","description":"Distinct authors in this bucket"},"avgSentiment":{"type":"number","description":"Average sentiment score. Range 0-10. 0 = very bearish, 5 = neutral, 10 = very bullish"},"avgAlpha":{"type":"number","description":"Average alpha (novelty/actionability) score. Range 0-10. Higher = more novel and actionable insights"},"totalLikes":{"type":"integer","description":"Total likes in this bucket"},"totalRetweets":{"type":"integer","description":"Total retweets in this bucket"},"totalReplies":{"type":"integer","description":"Total replies in this bucket"},"totalViews":{"type":"integer","description":"Total views in this bucket"},"veryBullish":{"type":"integer","description":"Count of tweets with sentiment >= 8"},"bullish":{"type":"integer","description":"Count of tweets with sentiment 6-7.9"},"neutral":{"type":"integer","description":"Count of tweets with sentiment 4-5.9"},"bearish":{"type":"integer","description":"Count of tweets with sentiment < 4"}}}}}}]}},"application/vnd.cambrian.deep42.social-data.token-analysis.v2.1+json":{"schema":{"oneOf":[{"type":"object","description":"Insufficient-data response. Returned when the token has fewer than 10 tweets or fewer than 3 distinct authors in the requested window, so no statistically meaningful analysis is produced. Retry with a larger days_back.","properties":{"tokenSymbol":{"type":"string","description":"Token symbol analyzed"},"insufficientData":{"type":"boolean","description":"True when analysis was withheld because the token had insufficient social coverage"},"totalTweets":{"type":"integer","description":"Tweets found in the window (below the minimum of 10)"},"uniqueAuthors":{"type":"integer","description":"Distinct authors found in the window (below the minimum of 3 for the aggregate path; 0 for the time-series path which does not compute global author distinctness)"},"analysisPeriodDays":{"type":"integer","description":"Days looked back"},"message":{"type":"string","description":"Human-readable explanation of why analysis was withheld"},"tokenSymbolDefaulted":{"type":"boolean","description":"True when token_symbol was omitted and the analysis defaulted to SOL"}}},{"type":"object","description":"Single token analysis object (when granularity='total')","properties":{"tokenSymbol":{"type":"string","description":"Token symbol analyzed"},"totalTweets":{"type":"integer","description":"Total high-quality tweets in the analysis period"},"uniqueAuthors":{"type":"integer","description":"Number of unique authors discussing this token"},"avgSentiment":{"type":"number","description":"Average sentiment score. Range 0-10. 0 = very bearish, 5 = neutral, 10 = very bullish"},"avgAlpha":{"type":"number","description":"Average alpha (novelty/actionability) score. Range 0-10. Higher = more novel and actionable insights"},"sentimentVolatility":{"type":"number","description":"Standard deviation of sentiment scores. Range 0-5. <1 = strong consensus, >2 = highly divided opinions"},"totalLikes":{"type":"integer","description":"Total likes across all tweets"},"totalRetweets":{"type":"integer","description":"Total retweets across all tweets"},"totalReplies":{"type":"integer","description":"Total replies across all tweets"},"totalViews":{"type":"integer","description":"Total views across all tweets"},"totalEngagement":{"type":"integer","description":"Total engagement (likes + retweets + replies)"},"engagementRate":{"type":"number","description":"Engagement as a percentage of views: (likes + retweets + replies) / views * 100. Typically 0-100; values above ~5 indicate above-average engagement"},"avgLikesPerTweet":{"type":"number","description":"Average likes per tweet"},"avgRetweetsPerTweet":{"type":"number","description":"Average retweets per tweet"},"veryBullishTweets":{"type":"integer","description":"Count of tweets with sentiment >= 8"},"bullishTweets":{"type":"integer","description":"Count of tweets with sentiment 6-7.9"},"neutralTweets":{"type":"integer","description":"Count of tweets with sentiment 4-5.9"},"bearishTweets":{"type":"integer","description":"Count of tweets with sentiment < 4"},"veryBullishPct":{"type":"number","description":"Percentage of very bullish tweets. Range 0-100"},"bullishPct":{"type":"number","description":"Percentage of bullish tweets. Range 0-100"},"neutralPct":{"type":"number","description":"Percentage of neutral tweets. Range 0-100"},"bearishPct":{"type":"number","description":"Percentage of bearish tweets. Range 0-100"},"firstTweet":{"type":"string","description":"Timestamp of earliest tweet in the period"},"latestTweet":{"type":"string","description":"Timestamp of most recent tweet in the period"},"activeDays":{"type":"integer","description":"Number of days with at least one tweet. In v2.1 and later, days are UTC dates, so a window of N days can touch N + 1 dates."},"analysisPeriodDays":{"type":"integer","description":"Total days covered by the analysis"},"tokenSymbolDefaulted":{"type":"boolean","description":"True when token_symbol was omitted and the analysis defaulted to SOL"},"priceCorrelationBullishAccuracy24h":{"type":"number","description":"Percentage of bullish signals followed by a price increase after 24 hours. Null when price history at this horizon is insufficient."},"priceCorrelationBullishAccuracy7d":{"type":"number","description":"% of bullish signals where price increased after 7 days"},"priceCorrelationBullishAccuracy30d":{"type":"number","description":"% of bullish signals where price increased after 30 days"},"priceCorrelationBearishAccuracy24h":{"type":"number","description":"% of bearish signals where price decreased after 24 hours"},"priceCorrelationBearishAccuracy7d":{"type":"number","description":"% of bearish signals where price decreased after 7 days"},"priceCorrelationBearishAccuracy30d":{"type":"number","description":"% of bearish signals where price decreased after 30 days"},"priceCorrelationBullishAvgReturn24h":{"type":"number","description":"Average % return 24 hours after bullish signal"},"priceCorrelationBullishAvgReturn7d":{"type":"number","description":"Average % return 7 days after bullish signal"},"priceCorrelationBullishAvgReturn30d":{"type":"number","description":"Average % return 30 days after bullish signal"},"priceCorrelationBearishAvgReturn24h":{"type":"number","description":"Average % return 24 hours after bearish signal"},"priceCorrelationBearishAvgReturn7d":{"type":"number","description":"Average % return 7 days after bearish signal"},"priceCorrelationBearishAvgReturn30d":{"type":"number","description":"Average % return 30 days after bearish signal"},"priceCorrelationBullishSignals":{"type":"integer","description":"Total bullish sentiment signals tracked over the trailing 90-day correlation window; not directly comparable to totalTweets, which counts tweets in the requested period"},"priceCorrelationBearishSignals":{"type":"integer","description":"Total bearish sentiment signals tracked over the trailing 90-day correlation window; not directly comparable to totalTweets, which counts tweets in the requested period"},"priceCorrelationEnrichedSignals":{"type":"integer","description":"Signals with completed price data"},"priceCorrelationPendingSignals":{"type":"integer","description":"Signals awaiting price data"},"priceCorrelationFirstSignalDate":{"type":"string","description":"Earliest signal date (YYYY-MM-DD)"},"priceCorrelationLastSignalDate":{"type":"string","description":"Latest signal date (YYYY-MM-DD)"}}},{"type":"object","description":"Time-series response (returned when granularity != 'total'). A wrapper object; the `timeseries` array holds one entry per fixed-width bucket, most-recent first, capped at 1000 buckets.","properties":{"tokenSymbol":{"type":"string","description":"Token symbol analyzed"},"granularity":{"type":"string","description":"Echo of the requested (normalized) granularity, e.g. '6h'"},"analysisPeriodDays":{"type":"integer","description":"Days looked back"},"tokenSymbolDefaulted":{"type":"boolean","description":"True when token_symbol was omitted and the analysis defaulted to SOL"},"bucketCount":{"type":"integer","description":"Number of time buckets returned in this response"},"maxBuckets":{"type":"integer","description":"Maximum buckets returnable in a single response (the row cap)"},"truncated":{"type":"boolean","description":"True when the requested days_back/granularity produced more buckets than the cap and the oldest buckets were dropped. The buckets returned are the most recent ones. Narrow days_back or use a coarser granularity to fit the full range."},"timeseries":{"type":"array","description":"One entry per time bucket (most-recent first, max 1000)","items":{"type":"object","properties":{"timeBucket":{"type":"string","description":"Bucket start timestamp (inclusive), in UTC. Buckets are fixed-width per the requested granularity, e.g. '2026-06-05 00:00:00+00'"},"tweetsCount":{"type":"integer","description":"High-quality tweets in this bucket"},"uniqueAuthors":{"type":"integer","description":"Distinct authors in this bucket"},"avgSentiment":{"type":"number","description":"Average sentiment score. Range 0-10. 0 = very bearish, 5 = neutral, 10 = very bullish"},"avgAlpha":{"type":"number","description":"Average alpha (novelty/actionability) score. Range 0-10. Higher = more novel and actionable insights"},"totalLikes":{"type":"integer","description":"Total likes in this bucket"},"totalRetweets":{"type":"integer","description":"Total retweets in this bucket"},"totalReplies":{"type":"integer","description":"Total replies in this bucket"},"totalViews":{"type":"integer","description":"Total views in this bucket"},"veryBullish":{"type":"integer","description":"Count of tweets with sentiment >= 8"},"bullish":{"type":"integer","description":"Count of tweets with sentiment 6-7.9"},"neutral":{"type":"integer","description":"Count of tweets with sentiment 4-5.9"},"bearish":{"type":"integer","description":"Count of tweets with sentiment < 4"}}}}}}]}}},"headers":{"Content-Type":{"description":"Response content type with version information","schema":{"type":"string","example":"application/vnd.cambrian.deep42.social-data.token-analysis.v2.1+json"}},"X-API-Version":{"description":"The resolved API version for this endpoint","schema":{"type":"string","example":"v1.0.0"}},"Deprecation":{"description":"Indicates the endpoint version is deprecated (RFC 8594)","schema":{"type":"string","example":"Sun, 31 Dec 2025 23:59:59 GMT"},"required":false},"Sunset":{"description":"When the endpoint version will no longer be available (RFC 8594)","schema":{"type":"string","example":"Sun, 31 Dec 2025 23:59:59 GMT"},"required":false},"X-API-Days-Until-Sunset":{"description":"Number of days until the version is sunset","schema":{"type":"integer","example":25},"required":false},"Link":{"description":"Links to successor version and migration documentation (RFC 8288)","schema":{"type":"string"},"required":false}}},"402":{"description":"Payment Required - x402 V2 payment needed to access this resource","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 V2 payment requirements","schema":{"type":"string"}},"WWW-Authenticate":{"description":"Authentication scheme","schema":{"type":"string","default":"X402"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequiredResponse"},"example":{"x402Version":2,"accepts":[{"scheme":"exact","network":"eip155:8453","amount":"50000","asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","payTo":"0xYOUR_WALLET_ADDRESS","maxTimeoutSeconds":600,"extra":{"name":"USD Coin","version":"2"}}],"resource":{"url":"https://api.cambrian.org/deep42/social-data/token-analysis","description":"Access to /deep42/social-data/token-analysis","mimeType":"application/json"}}}}},"406":{"description":"Not Acceptable - Unsupported endpoint version requested","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","example":"UNSUPPORTED_ENDPOINT_VERSION"},"message":{"type":"string"},"endpoint":{"type":"string"},"requested_version":{"type":"string"},"supported_versions":{"type":"array","items":{"type":"string"}},"current_version":{"type":"string"}}}}}}}},"410":{"description":"Gone - Endpoint version has been sunset","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","example":"ENDPOINT_VERSION_SUNSET"},"message":{"type":"string"},"endpoint":{"type":"string"},"sunset_date":{"type":"string","format":"date-time"},"current_version":{"type":"string"},"migration_guide":{"type":"string","format":"uri"}}}}}}}}},"tags":["Social Data","x402-enabled"],"x-rate-weight":3,"x-notes":{"performance":"Time-series queries with fine granularity (1h, 3h) may take longer to execute due to data volume. Consider using coarser granularity (1d, 7d) for better performance.","data_limits":"Maximum 1000 rows returned for time-series to ensure API responsiveness. Use appropriate days_back and granularity combinations.","backward_compatibility":"Default granularity='total' maintains exact same response format as before this update."},"x-available-versions":{"versions":[{"version":"3.0.0","state":"current","is_default":false,"released_at":"2026-10-28T23:08:15+00:00","accept_header":"application/vnd.cambrian.deep42.social-data.token-analysis.v3+json","becomes_default_at":"2026-11-27T23:08:15+00:00","changelog":["Relevance, sentiment and alpha scores come from a new scoring version. Scores, counts and rankings can differ from earlier versions.","Track records and price correlation are computed from the same scores as the rest of this version.","Includes every 2.1.0 change."]},{"version":"2.1.0","state":"current","is_default":true,"released_at":"2026-09-30T19:35:56+00:00","accept_header":"application/vnd.cambrian.deep42.social-data.token-analysis.v2.1+json","becomes_default_at":"2026-10-30T19:35:56+00:00","changelog":["`days_back` covers exactly the last `days_back` × 24 hours, in UTC.","`activeDays` counts UTC dates."]},{"version":"2.0.0","state":"current","is_default":false,"released_at":"2026-09-02T00:00:00+00:00","accept_header":"application/vnd.cambrian.deep42.social-data.token-analysis.v2+json","becomes_default_at":"2026-09-08T00:00:00+00:00"},{"version":"1.0.0","state":"current","is_default":false,"released_at":"2024-01-01T00:00:00+00:00","accept_header":"application/vnd.cambrian.deep42.social-data.token-analysis.v1+json"}],"default_version":"2.1.0","version_count":4},"x-api-version":"2.1.0","x-x402":{"pricing":{"amount":"50000","currency":"USDC","model":"per_request","description":"Pay 0.05 USDC per request"},"accepts":[{"network":"eip155:8453","asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"},{"network":"eip155:84532","asset":"0x036CbD53842c5426634e7929541eC2318f3dCF7e"}]}}},"/deep42/social-data/trending-momentum":{"get":{"summary":"Detect trending tokens with social momentum","description":"Identifies tokens with rapidly increasing social signals and momentum indicators","operationId":"getTrendingMomentum","parameters":[{"name":"lookback_hours","in":"query","required":false,"description":"Hours to look back for trend detection. Default: 24. Before v3, values outside 1 to 168 are clamped to the nearest bound. In v3 and later, they return 400.","schema":{"type":"integer","default":24,"minimum":1,"maximum":168}},{"name":"min_velocity","in":"query","required":false,"description":"Minimum velocity score (rate of change)","schema":{"type":"number","default":0.3,"minimum":0}},{"name":"limit","in":"query","required":false,"description":"Number of trending tokens to return. In time-series mode, the maximum number of rows. In v2.1 and later, time-series mode returns every bucket for up to this many tokens.","schema":{"type":"integer","default":15,"maximum":300}},{"name":"granularity","in":"query","required":false,"description":"Time granularity for momentum analysis. 'total' returns aggregate momentum ranking (single result set). Other values return time-series momentum data showing velocity changes over time. Time-series responses limited to 1000 rows maximum for performance. In v2.1 and later, each time-series bucket has the width of this value, the buckets cover the full lookback_hours window, and a value outside this list returns 400.","schema":{"type":"string","default":"total","enum":["total","1h","3h","6h","12h","24h","1d","3d","7d","30d"],"examples":{"aggregate":{"value":"total","summary":"Single momentum ranking (current behavior)"},"hourly_trends":{"value":"1h","summary":"Hourly momentum evolution"},"daily_trends":{"value":"1d","summary":"Daily momentum patterns"}}}}],"responses":{"200":{"description":"Trending tokens with momentum metrics. Response format depends on granularity: 'total' returns aggregate momentum ranking. Time-series granularities return momentum evolution over time (max 1000 rows).","content":{"application/json":{"schema":{"type":"array","description":"Direct array of trending momentum data (no wrapper)","items":{"type":"object","properties":{"tokenSymbol":{"type":"string","description":"Token symbol"},"momentumScore":{"type":"number","description":"Composite momentum score combining velocity, volume, and quality. Unbounded, typically 0-100. >10 = trending, >50 = viral momentum"},"tweetVelocity":{"type":"number","description":"Rate of tweet volume change as a multiplier. 1.0 = flat, 2.0 = doubled. >1.5 = strong acceleration"},"engagementVelocity":{"type":"number","description":"With granularity=total, the average engagement (likes + retweets + replies) per tweet in the lookback window. Unbounded, 0 or more. Higher means more interaction per tweet. In time-series responses, the engagement of the bucket divided by the engagement of the previous bucket for the same token: 1.0 = flat, 2.0 = doubled, and the first bucket is 1.0. A value of 0 is returned as 1. In v2.1 and later, a value of 0 is returned as 0."},"recentTweets":{"type":"integer","description":"Recent tweet count in the lookback window. Time-series responses return 0. In v2.1 and later, each time-series row gives the tweet count of its bucket."},"uniqueAuthors":{"type":"integer","description":"Number of unique authors discussing this token"},"qualityScore":{"type":"number","description":"Combined average sentiment and alpha quality. Range 0-20. >10 = above-average combined quality, >15 = high combined quality"},"qualityDelta":{"type":"number","description":"Change in the combined quality score from the preceding equal-length period when granularity=total. Range -20 to 20. Positive means quality rose; negative means quality fell. Returns 0 when no prior period is available. Time-series responses return 0 because this comparison is not calculated."},"sentiment":{"type":"number","description":"Average sentiment score. Range 0-10. 0 = very bearish, 5 = neutral, 10 = very bullish"},"totalReach":{"type":"integer","description":"Total views across all tweets in the window"},"trendDirection":{"type":"string","description":"Trending direction: 'up' or 'down'"},"timeBucket":{"type":"string","description":"Bucket start time in UTC, for example '2026-09-22T00:00:00Z'. Buckets are aligned to the Unix epoch and have the width of granularity. Only present in time-series responses.","x-version-support":["2.1.0","3.0.0"]}}}}},"application/vnd.cambrian.deep42.social-data.trending-momentum.v2.1+json":{"schema":{"type":"array","description":"Direct array of trending momentum data (no wrapper)","items":{"type":"object","properties":{"tokenSymbol":{"type":"string","description":"Token symbol"},"momentumScore":{"type":"number","description":"Composite momentum score combining velocity, volume, and quality. Unbounded, typically 0-100. >10 = trending, >50 = viral momentum"},"tweetVelocity":{"type":"number","description":"Rate of tweet volume change as a multiplier. 1.0 = flat, 2.0 = doubled. >1.5 = strong acceleration"},"engagementVelocity":{"type":"number","description":"With granularity=total, the average engagement (likes + retweets + replies) per tweet in the lookback window. Unbounded, 0 or more. Higher means more interaction per tweet. In time-series responses, the engagement of the bucket divided by the engagement of the previous bucket for the same token: 1.0 = flat, 2.0 = doubled, and the first bucket is 1.0. A value of 0 is returned as 1. In v2.1 and later, a value of 0 is returned as 0."},"recentTweets":{"type":"integer","description":"Recent tweet count in the lookback window. Time-series responses return 0. In v2.1 and later, each time-series row gives the tweet count of its bucket."},"uniqueAuthors":{"type":"integer","description":"Number of unique authors discussing this token"},"qualityScore":{"type":"number","description":"Combined average sentiment and alpha quality. Range 0-20. >10 = above-average combined quality, >15 = high combined quality"},"qualityDelta":{"type":"number","description":"Change in the combined quality score from the preceding equal-length period when granularity=total. Range -20 to 20. Positive means quality rose; negative means quality fell. Returns 0 when no prior period is available. Time-series responses return 0 because this comparison is not calculated."},"sentiment":{"type":"number","description":"Average sentiment score. Range 0-10. 0 = very bearish, 5 = neutral, 10 = very bullish"},"totalReach":{"type":"integer","description":"Total views across all tweets in the window"},"trendDirection":{"type":"string","description":"Trending direction: 'up' or 'down'"},"timeBucket":{"type":"string","description":"Bucket start time in UTC, for example '2026-09-22T00:00:00Z'. Buckets are aligned to the Unix epoch and have the width of granularity. Only present in time-series responses.","x-version-support":["2.1.0","3.0.0"]}}}}}},"headers":{"Content-Type":{"description":"Response content type with version information","schema":{"type":"string","example":"application/vnd.cambrian.deep42.social-data.trending-momentum.v2.1+json"}},"X-API-Version":{"description":"The resolved API version for this endpoint","schema":{"type":"string","example":"v1.0.0"}},"Deprecation":{"description":"Indicates the endpoint version is deprecated (RFC 8594)","schema":{"type":"string","example":"Sun, 31 Dec 2025 23:59:59 GMT"},"required":false},"Sunset":{"description":"When the endpoint version will no longer be available (RFC 8594)","schema":{"type":"string","example":"Sun, 31 Dec 2025 23:59:59 GMT"},"required":false},"X-API-Days-Until-Sunset":{"description":"Number of days until the version is sunset","schema":{"type":"integer","example":25},"required":false},"Link":{"description":"Links to successor version and migration documentation (RFC 8288)","schema":{"type":"string"},"required":false}}},"402":{"description":"Payment Required - x402 V2 payment needed to access this resource","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 V2 payment requirements","schema":{"type":"string"}},"WWW-Authenticate":{"description":"Authentication scheme","schema":{"type":"string","default":"X402"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequiredResponse"},"example":{"x402Version":2,"accepts":[{"scheme":"exact","network":"eip155:8453","amount":"50000","asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","payTo":"0xYOUR_WALLET_ADDRESS","maxTimeoutSeconds":600,"extra":{"name":"USD Coin","version":"2"}}],"resource":{"url":"https://api.cambrian.org/deep42/social-data/trending-momentum","description":"Access to /deep42/social-data/trending-momentum","mimeType":"application/json"}}}}},"406":{"description":"Not Acceptable - Unsupported endpoint version requested","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","example":"UNSUPPORTED_ENDPOINT_VERSION"},"message":{"type":"string"},"endpoint":{"type":"string"},"requested_version":{"type":"string"},"supported_versions":{"type":"array","items":{"type":"string"}},"current_version":{"type":"string"}}}}}}}},"410":{"description":"Gone - Endpoint version has been sunset","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","example":"ENDPOINT_VERSION_SUNSET"},"message":{"type":"string"},"endpoint":{"type":"string"},"sunset_date":{"type":"string","format":"date-time"},"current_version":{"type":"string"},"migration_guide":{"type":"string","format":"uri"}}}}}}}}},"tags":["Social Data","x402-enabled"],"x-rate-weight":2,"x-notes":{"time_series_behavior":"Time-series granularity shows momentum velocity changes between consecutive time buckets using LAG window functions.","data_limits":"Maximum 1000 rows for time-series responses. Aggregate responses limited by 'limit' parameter (max 300).","performance":"Fine-grained time-series (1h, 3h) require more computation. Consider daily granularity for faster responses.","velocity_calculation":"Time-series momentum compares each bucket to the previous bucket. First bucket may have velocity=1.0 as baseline."},"x-available-versions":{"versions":[{"version":"3.0.0","state":"current","is_default":false,"released_at":"2026-10-28T23:08:15+00:00","accept_header":"application/vnd.cambrian.deep42.social-data.trending-momentum.v3+json","becomes_default_at":"2026-11-27T23:08:15+00:00","changelog":["Relevance, sentiment and alpha scores come from a new scoring version. Scores, counts and rankings can differ from earlier versions.","Returns 400 for a `lookback_hours` outside 1 to 168. Earlier versions clamp it to the nearest bound.","Includes every 2.1.0 change."]},{"version":"2.1.0","state":"current","is_default":true,"released_at":"2026-09-30T22:19:36+00:00","accept_header":"application/vnd.cambrian.deep42.social-data.trending-momentum.v2.1+json","becomes_default_at":"2026-10-30T22:19:36+00:00","changelog":["Time-series rows are grouped by token in rank order, newest bucket first. Each row has its bucket start time in `timeBucket`.","Time-series rows give the tweet count of their bucket in `recentTweets`, instead of 0.","Time-series buckets have the width of `granularity` and cover the full `lookback_hours` window.","In time-series mode, `limit` counts tokens instead of rows.","Returns 400 for an unsupported `granularity` or a non-numeric `limit`, `lookback_hours` or `min_velocity`.","`granularity` is not case-sensitive.","Returns an `engagementVelocity` of 0 as 0, instead of 1."]},{"version":"2.0.0","state":"current","is_default":false,"released_at":"2026-09-02T00:00:00+00:00","accept_header":"application/vnd.cambrian.deep42.social-data.trending-momentum.v2+json","becomes_default_at":"2026-09-08T00:00:00+00:00"},{"version":"1.1.0","state":"current","is_default":false,"released_at":"2025-11-25T20:40:16.851201+00:00","accept_header":"application/vnd.cambrian.deep42.social-data.trending-momentum.v1.1+json"},{"version":"1.0.0","state":"current","is_default":false,"released_at":"2024-01-01T00:00:00+00:00","accept_header":"application/vnd.cambrian.deep42.social-data.trending-momentum.v1+json"}],"default_version":"2.1.0","version_count":5},"x-api-version":"2.1.0","x-x402":{"pricing":{"amount":"50000","currency":"USDC","model":"per_request","description":"Pay 0.05 USDC per request"},"accepts":[{"network":"eip155:8453","asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"},{"network":"eip155:84532","asset":"0x036CbD53842c5426634e7929541eC2318f3dCF7e"}]}}}},"tags":[{"name":"Agents","description":"AI agent endpoints for blockchain intelligence"},{"name":"Social Data","description":"Social sentiment and alpha detection"},{"name":"x402","description":"x402 payment protocol endpoints and configuration","externalDocs":{"description":"x402 Protocol Documentation","url":"https://x402.gitbook.io/x402"}},{"name":"x402-enabled","description":"Endpoints that support x402 micropayments"}],"x-x402-manifest":{"protocol_version":"2.0","payment_flow":"standard","facilitator_required":false,"agent_support":true,"documentation":"https://x402.gitbook.io/x402","reference_implementation":"https://github.com/coinbase/x402"}}