Token Analysis

Overview

The Token Analysis endpoint provides comprehensive social intelligence reports for cryptocurrency tokens, analyzing sentiment, engagement, and price correlation metrics from high-quality social media content. It delivers both aggregate analysis and time-series data with configurable granularity.

Business Value

• Real-time Market Intelligence: Access curated insights from 38K high-quality DeFi tweets to identify emerging trends and sentiment shifts
• Multi-dimensional Scoring: Comprehensive analysis across sentiment, alpha potential, legitimacy, technical accuracy, and engagement metrics
• Investment Signal Detection: Identify potential alpha opportunities through AI-scored social media analysis from credible sources
• Risk Assessment: Evaluate content legitimacy and technical accuracy to filter out noise and misinformation
• Social Trading Insights: Track engagement metrics and content previews to understand market discourse and community sentiment

Endpoint Details

URL:

https://deep42.cambrian.network/api/v1/deep42/social-data/token-analysis

Method: GET Authentication: Required via X-API-KEY header

Query Parameters

Parameter	Type	Required	Default	Description
token_symbol	string	false	SOL	Token symbol to analyze (e.g. BTC, ETH, SOL). Defaults to SOL when omitted; in that case the response includes tokenSymbolDefaulted=true.
days_back	integer	false	7	Number of days of history to analyze. Accepted range 1 to 90.
granularity	string	false	total	Aggregation granularity. Use 'total' for a single aggregate object, or a fixed bucket width expressed as h (hours) or 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.

Response Field Descriptions

Response Field	Type	Description
tokenSymbol	string	Token symbol analyzed
totalTweets	integer	Total high-quality tweets in the analysis period
uniqueAuthors	integer	Number of unique authors discussing this token
avgSentiment	number	Average sentiment score. Range 0-10. 0 = very bearish, 5 = neutral, 10 = very bullish
avgAlpha	number	Average alpha (novelty/actionability) score. Range 0-10. Higher = more novel and actionable insights
sentimentVolatility	number	Standard deviation of sentiment scores. Range 0-5. <1 = strong consensus, >2 = highly divided opinions
totalLikes	integer	Total likes across all tweets
totalRetweets	integer	Total retweets across all tweets
totalReplies	integer	Total replies across all tweets
totalViews	integer	Total views across all tweets
totalEngagement	integer	Total engagement (likes + retweets + replies)
engagementRate	number	Engagement divided by views. Range 0-1. >0.05 = above average engagement
avgLikesPerTweet	number	Average likes per tweet
avgRetweetsPerTweet	number	Average retweets per tweet
veryBullishTweets	integer	Count of tweets with sentiment >= 8
bullishTweets	integer	Count of tweets with sentiment 6-7.9
neutralTweets	integer	Count of tweets with sentiment 4-5.9
bearishTweets	integer	Count of tweets with sentiment < 4
veryBullishPct	number	Percentage of very bullish tweets. Range 0-100
bullishPct	number	Percentage of bullish tweets. Range 0-100
neutralPct	number	Percentage of neutral tweets. Range 0-100
bearishPct	number	Percentage of bearish tweets. Range 0-100
firstTweet	string	Timestamp of earliest tweet in the period
latestTweet	string	Timestamp of most recent tweet in the period
activeDays	integer	Number of days with at least one tweet
analysisPeriodDays	integer	Total days covered by the analysis
tokenSymbolDefaulted	boolean	True when token_symbol was omitted and the analysis defaulted to SOL
priceCorrelationBullishAccuracy24h	number	Percentage of bullish signals followed by a price increase after 24 hours
priceCorrelationBullishAccuracy7d	number	Percentage of bullish signals where price increased after 7 days
priceCorrelationBullishAccuracy30d	number	Percentage of bullish signals where price increased after 30 days
priceCorrelationBearishAccuracy24h	number	Percentage of bearish signals where price decreased after 24 hours
priceCorrelationBearishAccuracy7d	number	Percentage of bearish signals where price decreased after 7 days
priceCorrelationBearishAccuracy30d	number	Percentage of bearish signals where price decreased after 30 days
priceCorrelationBullishAvgReturn24h	number	Average % return 24 hours after bullish signal
priceCorrelationBullishAvgReturn7d	number	Average % return 7 days after bullish signal
priceCorrelationBullishAvgReturn30d	number	Average % return 30 days after bullish signal
priceCorrelationBearishAvgReturn24h	number	Average % return 24 hours after bearish signal
priceCorrelationBearishAvgReturn7d	number	Average % return 7 days after bearish signal
priceCorrelationBearishAvgReturn30d	number	Average % return 30 days after bearish signal
priceCorrelationBullishSignals	integer	Total bullish sentiment signals tracked
priceCorrelationBearishSignals	integer	Total bearish sentiment signals tracked
priceCorrelationEnrichedSignals	integer	Signals with completed price data
priceCorrelationPendingSignals	integer	Signals awaiting price data
priceCorrelationFirstSignalDate	string	Earliest signal date (YYYY-MM-DD)
priceCorrelationLastSignalDate	string	Latest signal date (YYYY-MM-DD)

Examples

1. Default SOL Analysis

Get a comprehensive social analysis for Solana using default parameters (7 days back, aggregate view).

curl -X GET "https://deep42.cambrian.network/api/v1/deep42/social-data/token-analysis" \
  -H "X-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response:

{
  "tokenSymbol": "SOL",
  "totalTweets": 342,
  "uniqueAuthors": 87,
  "avgSentiment": 6.8,
  "avgAlpha": 7.2,
  "sentimentVolatility": 1.4,
  "totalLikes": 15420,
  "totalRetweets": 8965,
  "totalReplies": 2134,
  "totalViews": 245780,
  "totalEngagement": 26519,
  "engagementRate": 0.108,
  "avgLikesPerTweet": 45.1,
  "avgRetweetsPerTweet": 26.2,
  "veryBullishTweets": 89,
  "bullishTweets": 156,
  "neutralTweets": 78,
  "bearishTweets": 19,
  "veryBullishPct": 26.0,
  "bullishPct": 45.6,
  "neutralPct": 22.8,
  "bearishPct": 5.6,
  "firstTweet": "2026-05-29T08:15:42Z",
  "latestTweet": "2026-06-05T14:32:18Z",
  "activeDays": 7,
  "analysisPeriodDays": 7,
  "tokenSymbolDefaulted": true,
  "priceCorrelationBullishAccuracy24h": 68.5,
  "priceCorrelationBullishAccuracy7d": 72.3,
  "priceCorrelationBullishAccuracy30d": 65.1,
  "priceCorrelationBearishAccuracy24h": 71.2,
  "priceCorrelationBearishAccuracy7d": 69.8,
  "priceCorrelationBearishAccuracy30d": 74.5,
  "priceCorrelationBullishAvgReturn24h": 3.2,
  "priceCorrelationBullishAvgReturn7d": 8.7,
  "priceCorrelationBullishAvgReturn30d": 15.4,
  "priceCorrelationBearishAvgReturn24h": -2.8,
  "priceCorrelationBearishAvgReturn7d": -6.1,
  "priceCorrelationBearishAvgReturn30d": -11.2,
  "priceCorrelationBullishSignals": 127,
  "priceCorrelationBearishSignals": 34,
  "priceCorrelationEnrichedSignals": 148,
  "priceCorrelationPendingSignals": 13,
  "priceCorrelationFirstSignalDate": "2026-03-07",
  "priceCorrelationLastSignalDate": "2026-06-04"
}

The response shows SOL has strong bullish sentiment (avgSentiment: 6.8) with 71.6% of tweets being bullish or very bullish. The price correlation metrics indicate that bullish signals have been 72.3% accurate over 7-day periods, with an average return of 8.7%.

2. Bitcoin Time Series Analysis

Analyze Bitcoin sentiment over 30 days with daily granularity to see sentiment trends over time.

curl -X GET "https://deep42.cambrian.network/api/v1/deep42/social-data/token-analysis?token_symbol=BTC&days_back=30&granularity=1d" \
  -H "X-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response:

{
  "tokenSymbol": "BTC",
  "granularity": "1d", 
  "analysisPeriodDays": 30,
  "tokenSymbolDefaulted": false,
  "timeseries": [
    {
      "timeBucket": "2026-06-05 00:00:00-07",
      "tweetsCount": 45,
      "uniqueAuthors": 23,
      "avgSentiment": 7.2,
      "avgAlpha": 6.8,
      "totalLikes": 1250,
      "totalRetweets": 780,
      "totalReplies": 156,
      "totalViews": 18420,
      "veryBullish": 12,
      "bullish": 22,
      "neutral": 8,
      "bearish": 3
    }
  ]
}

This time-series response shows daily sentiment buckets with Bitcoin having strong bullish sentiment (7.2/10) on June 5th, with 75.6% of tweets being bullish or very bullish (34 out of 45 tweets).

x402 Payment Option

This endpoint supports pay-per-use access via the x402 payment protocol (v2) — pay $0.05 USDC per request using blockchain micropayments. No API key required.

Quick Start (TypeScript)

npm install @x402/fetch @x402/evm viem

import { x402Client } from "@x402/core/client";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const signer = privateKeyToAccount(process.env.EVM_PRIVATE_KEY as `0x${string}`);
const client = new x402Client();
client.register("eip155:*", new ExactEvmScheme(signer));

const fetchWithPayment = wrapFetchWithPayment(fetch, client);
const response = await fetchWithPayment(
  "https://x402.cambrian.network/api/v1/deep42/social-data/token-analysis"
);
const data = await response.json();

Quick Start (Python)

pip install "x402[httpx]"

import asyncio, os
from eth_account import Account
from x402 import x402Client
from x402.http.clients import x402HttpxClient
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client

async def main():
    client = x402Client()
    account = Account.from_key(os.getenv("EVM_PRIVATE_KEY"))
    register_exact_evm_client(client, EthAccountSigner(account))

    async with x402HttpxClient(client) as http:
        response = await http.get("https://x402.cambrian.network/api/v1/deep42/social-data/token-analysis")
        print(response.json())

asyncio.run(main())

Payment Flow

1. Send a normal request to the endpoint (no API key needed)
2. Server returns 402 Payment Required with payment details
3. The x402 SDK automatically signs a payment authorization with your wallet
4. The SDK resubmits the request with the signed payment
5. Server verifies payment and returns the API response

The x402 SDK handles steps 2–5 automatically.

Network: Base (chain ID 8453) | Currency: USDC | Price: $0.05 per request

---

Related Endpoints

• /api/v1/deep42/social-data/alpha-tweet-detection - Feed of tweets detected as having high alpha potential for cryptocurrency investments
• /api/v1/deep42/social-data/influencer-credibility - Returns cryptocurrency influencers ranked by credibility score, track record, accuracy, and engagement metrics
• /api/v1/deep42/social-data/sentiment-shifts - Identifies tokens with significant sentiment changes that could signal market movements and trading opportunities