Cambrian Detect trending tokens with social momentum API
GET /api/v1/deep42/social-data/trending-momentum
Trending Momentum
Overview
Identifies tokens with rapidly increasing social signals and momentum by combining tweet velocity, engagement velocity, and quality signals into a single composite score. You can view either an aggregate ranking or a time-series breakdown of momentum over time.
Business Value
- Early trend detection: Surfaces tokens gaining social traction before they become widely known, giving traders a timing edge.
- Composite momentum scoring: Combines velocity, volume, and quality signals into a single score so teams don't need to build their own weighting logic.
- Time-series flexibility: Supports both a single aggregate ranking and granular time-series views, useful for quick screens as well as deeper trend analysis.
- Quality-aware ranking: Pairs momentum with sentiment and quality scores, so you can tell high-velocity but low-quality chatter apart from credible trends.
- Configurable sensitivity: You can tune the lookback window and velocity thresholds to match different trading horizons, from intraday to multi-day.
Endpoint Details
URL:
https://api.cambrian.org/deep42/social-data/trending-momentum
Method: GET
Authentication: Required via X-API-KEY header
Query Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| lookback_hours | integer | No | 24 | Hours to look back for trend detection. Minimum 1, maximum 168. Before v3, values outside 1–168 are clamped to the nearest bound. In v3 and later, out-of-range values return 400. |
| min_velocity | number | No | 0.3 | Minimum velocity score (rate of change). Minimum 0. |
| limit | integer | No | 15 | Number of trending tokens to return. Maximum 300. 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. |
| granularity | string | No | total | Time granularity for momentum analysis. Allowed values: total, 1h, 3h, 6h, 12h, 24h, 1d, 3d, 7d, 30d. total returns a single aggregate momentum ranking; other values return time-series momentum data (max 1000 rows). In v2.1 and later, each bucket has the width of this value, buckets cover the full lookback_hours window, and an unsupported value returns 400. |
Response Field Descriptions
| Response Field | Type | Description |
|---|---|---|
| tokenSymbol | string | Token symbol. |
| momentumScore | number | Composite momentum score combining velocity, volume, and quality. Unbounded, typically 0–100. >10 = trending, >50 = viral momentum. |
| tweetVelocity | number | Rate of tweet volume change as a multiplier. 1.0 = flat, 2.0 = doubled. >1.5 = strong acceleration. |
| engagementVelocity | number | With granularity=total, the average engagement (likes + retweets + replies) per tweet in the lookback window. Unbounded, 0 or more. 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); 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 | integer | 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 | integer | Number of unique authors discussing this token. |
| qualityScore | number | Combined average sentiment and alpha quality. Range 0–20. >10 = above-average combined quality, >15 = high combined quality. |
| qualityDelta | number | 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 | number | Average sentiment score. Range 0–10. 0 = very bearish, 5 = neutral, 10 = very bullish. |
| totalReach | integer | Total views across all tweets in the window. |
| trendDirection | string | Trending direction: up or down. |
| timeBucket | string | 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. |
Examples
Fetch top trending tokens
Retrieve the top 3 tokens ranked by aggregate momentum score.
curl -X GET "https://api.cambrian.org/deep42/social-data/trending-momentum?limit=3" \
-H "X-API-KEY: YOUR_API_KEY" \
-H "Content-Type: application/json"
Response:
[
{
"tokenSymbol": "MIHAO",
"recentTweets": 30,
"uniqueAuthors": 6,
"sentiment": 5.1,
"qualityScore": 7.87,
"qualityDelta": 0,
"totalReach": 161693,
"tweetVelocity": 11,
"engagementVelocity": 26,
"momentumScore": 1037.83
},
{
"tokenSymbol": "PHA",
"recentTweets": 18,
"uniqueAuthors": 9,
"sentiment": 7.94,
"qualityScore": 9.39,
"qualityDelta": 0,
"totalReach": 21781,
"tweetVelocity": 7,
"engagementVelocity": 12.83,
"momentumScore": 656.49
},
{
"tokenSymbol": "ZIG",
"recentTweets": 23,
"uniqueAuthors": 23,
"sentiment": 7.43,
"qualityScore": 13.61,
"qualityDelta": 3.94,
"totalReach": 44696,
"tweetVelocity": 4.33,
"engagementVelocity": 85.87,
"momentumScore": 631.44
}
]
The limit=3 parameter restricts this result set to 3 items. MIHAO leads with the highest momentumScore (1037.83), driven by strong tweetVelocity (11) and engagementVelocity (26). ZIG shows the highest qualityScore (13.61) and a positive qualityDelta (3.94), so its discussion quality is rising alongside its momentum.
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.org/deep42/social-data/trending-momentum"
);
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.org/deep42/social-data/trending-momentum")
print(response.json())
asyncio.run(main())
Payment Flow
- Send a normal request to the endpoint (no API key needed)
- Server returns
402 Payment Requiredwith 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-5 automatically.
Network: Base (chain ID 8453) | Currency: USDC | Price: $0.05 per request
API Versioning
This endpoint supports multiple API versions. Use the Accept header to request a specific version.
Available Versions
| Version | State | Default | Accept Header |
|---|---|---|---|
| 1.0.0 | Current | No | application/vnd.cambrian.deep42.social-data.trending-momentum.v1+json |
| 1.1.0 | Current | No | application/vnd.cambrian.deep42.social-data.trending-momentum.v1.1+json |
| 2.0.0 | Current | No | application/vnd.cambrian.deep42.social-data.trending-momentum.v2+json |
| 2.1.0 | Current | Yes | application/vnd.cambrian.deep42.social-data.trending-momentum.v2.1+json |
| 3.0.0 | Current | No | application/vnd.cambrian.deep42.social-data.trending-momentum.v3+json |
How to Request a Specific Version
curl -X GET "https://api.cambrian.org/deep42/social-data/trending-momentum" \
-H "X-API-KEY: YOUR_API_KEY" \
-H "Accept: application/vnd.cambrian.deep42.social-data.trending-momentum.v1+json"
Version Lifecycle
- Current: Actively maintained and recommended for new integrations
- Deprecated: Still functional but scheduled for removal (check
deprecated_at) - Sunset: No longer available (returns
410 Gone)
Note: If you don't specify an Accept header, the API returns the default version (2.1.0).
Related Endpoints
- /deep42/social-data/alpha-tweet-detection - Feed of tweets detected as having high alpha potential for cryptocurrency investments, scored on sentiment, alpha, legitimacy, and technical accuracy.
- /deep42/social-data/influencer-credibility - Returns cryptocurrency influencers with recent activity and historical directional-price metrics.
- /deep42/social-data/sentiment-shifts - Identifies tokens with significant sentiment changes that could signal market movements and trading opportunities.
- /deep42/social-data/token-analysis - Comprehensive social intelligence report for a cryptocurrency token with sentiment analysis.