Cambrian Detect trending tokens with social momentum API

By Cambrian Network deep42

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

  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


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.