Token Analysis
Returns a comprehensive social intelligence report for a single cryptocurrency token, covering tweet volume, author reach, sentiment distribution, engagement, and how past bullish/bearish sentiment has historically lined up with subsequent price movement. Results can be returned as one aggregate snapshot over the requested period, or as a time series of fixed-width buckets for trend analysis.
Parameters
Responses
Examples
1. Default aggregate analysis (token symbol omitted)
Shows what happens when `token_symbol` is left out: the analysis falls back to SOL over the default 7-day window and returns a single aggregate object with sentiment breakdowns, engagement metrics, and sentiment-to-price correlation.
Response:
2 {
3 "tokenSymbol": "SOL",
4 "totalTweets": 1585,
5 "uniqueAuthors": 916,
6 "avgSentiment": 6.18,
7 "avgAlpha": 1.52,
8 "sentimentVolatility": 1.47,
9 "totalLikes": 66723,
10 "totalRetweets": 17818,
11 "totalReplies": 27830,
12 "totalViews": 4311025,
13 "totalEngagement": 112371,
14 "engagementRate": 2.61,
15 "avgLikesPerTweet": 42.1,
16 "avgRetweetsPerTweet": 11.2,
17 "veryBullishTweets": 339,
18 "bullishTweets": 654,
19 "neutralTweets": 549,
20 "bearishTweets": 43,
21 "veryBullishPct": 21.4,
22 "bullishPct": 41.3,
23 "neutralPct": 34.6,
24 "bearishPct": 2.7,
25 "firstTweet": "2026-09-23T19:57:25+00:00",
26 "latestTweet": "2026-09-30T12:00:03+00:00",
27 "activeDays": 8,
28 "analysisPeriodDays": 7,
29 "priceCorrelationBullishAccuracy24h": 55.3,
30 "priceCorrelationBullishAccuracy7d": 57,
31 "priceCorrelationBullishAccuracy30d": 72.8,
32 "priceCorrelationBearishAccuracy24h": 46.6,
33 "priceCorrelationBearishAccuracy7d": 42,
34 "priceCorrelationBearishAccuracy30d": 32.6,
35 "priceCorrelationBullishAvgReturn24h": 0.49,
36 "priceCorrelationBullishAvgReturn7d": 3.37,
37 "priceCorrelationBullishAvgReturn30d": 14.91,
38 "priceCorrelationBearishAvgReturn24h": 0.27,
39 "priceCorrelationBearishAvgReturn7d": 2.83,
40 "priceCorrelationBearishAvgReturn30d": 13.77,
41 "priceCorrelationBullishSignals": 10520,
42 "priceCorrelationBearishSignals": 1664,
43 "priceCorrelationEnrichedSignals": 11400,
44 "priceCorrelationPendingSignals": 784,
45 "priceCorrelationFirstSignalDate": "2026-07-02",
46 "priceCorrelationLastSignalDate": "2026-09-30",
47 "tokenSymbolDefaulted": true
48 }
49]
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.
Quickstart (Typescript)
2import { ExactEvmScheme } from "@x402/evm/exact/client";
3import { wrapFetchWithPayment } from "@x402/fetch";
4import { privateKeyToAccount } from "viem/accounts";
5const signer = privateKeyToAccount(process.env.EVM_PRIVATE_KEY as `0x${string}`);
6const client = new x402Client();
7client.register("eip155:*", new ExactEvmScheme(signer));
8const fetchWithPayment = wrapFetchWithPayment(fetch, client);
9const response = await fetchWithPayment(
10 "https://x402.cambrian.org/deep42/social-data/token-analysis"
11);
12const data = await response.json();
Quickstart (Python)
2from eth_account import Account
3from x402 import x402Client
4from x402.http.clients import x402HttpxClient
5from x402.mechanisms.evm import EthAccountSigner
6from x402.mechanisms.evm.exact.register import register_exact_evm_client
7async def main():
8 client = x402Client()
9 account = Account.from_key(os.getenv("EVM_PRIVATE_KEY"))
10 register_exact_evm_client(client, EthAccountSigner(account))
11 async with x402HttpxClient(client) as http:
12 response = await http.get("https://x402.cambrian.org/deep42/social-data/token-analysis")
13 print(response.json())
14asyncio.run(main())
Payment Flow
- Send a normal request to the endpoint (no API key needed)
- Server returns 402 Payment Required with payment details
- The x402 SDK automatically signs a payment authorization with your wallet
- The SDK resubmits the request with the signed payment
- Server verifies payment and returns the API response
The x402 SDK handles steps 2 through 5 automatically.
Network: Base (chain ID 8453) | Currency: USDC | Price: $0.05 per request