Trending Momentum

Overview

Identifies tokens with rapidly increasing social signals and momentum indicators. The endpoint combines tweet and engagement velocity, quality, and sentiment into a single composite momentum score, and can return either an aggregate momentum ranking or a time-series view of momentum evolution.

Business Value

• Early trend detection: Surfaces tokens gaining social traction based on velocity multipliers rather than raw tweet counts, so trends can be caught before they become obvious.
• Quality-weighted signals: Combines tweet and engagement velocity with author credibility (qualityScore) so momentum driven by low-quality accounts doesn't dominate rankings.
• Tunable detection window: lookback_hours (1-168) lets teams adjust sensitivity from short-term spikes to week-long trend confirmation.
• Momentum evolution tracking: Non-total granularity values show how velocity changes bucket-to-bucket using LAG-based comparisons, which is useful for charting acceleration or deceleration.
• Reach and sentiment context: totalReach and sentiment let consumers weigh momentum against actual audience size and directional tone before acting on a signal.

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.
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 50.
granularity	string	No	total	Time granularity for momentum analysis. total returns a single aggregate momentum ranking. Other values (1h, 3h, 6h, 12h, 24h, 1d, 3d, 7d, 30d) return time-series momentum data showing velocity changes over time, limited to 1000 rows maximum.

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	Rate of engagement change as a multiplier. 1.0 = flat, 2.0 = doubled. >1.5 = strong acceleration.
recentTweets	integer	Recent tweet count in the lookback window.
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	Quality-score change indicator returned alongside qualityScore; not further specified in the endpoint schema.
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. Only present for time-series (non-total granularity) queries.
timeBucket	string	Time bucket label (e.g., 2025-03-26T12:00:00Z). Only present for time-series (non-total granularity) queries.

Examples

Aggregate Momentum Ranking

Retrieves the top trending tokens ranked by composite momentum score using default parameters (aggregate total granularity).

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": "INDEX",
    "recentTweets": 8,
    "uniqueAuthors": 6,
    "sentiment": 8.63,
    "qualityScore": 15.75,
    "qualityDelta": 0,
    "totalReach": 17527,
    "tweetVelocity": 3.67,
    "engagementVelocity": 35,
    "momentumScore": 564.31
  },
  {
    "tokenSymbol": "BDX",
    "recentTweets": 4,
    "uniqueAuthors": 4,
    "sentiment": 7.75,
    "qualityScore": 15,
    "qualityDelta": 0,
    "totalReach": 105988,
    "tweetVelocity": 2.33,
    "engagementVelocity": 77.5,
    "momentumScore": 404.99
  },
  {
    "tokenSymbol": "PONS",
    "recentTweets": 5,
    "uniqueAuthors": 4,
    "sentiment": 8,
    "qualityScore": 15,
    "qualityDelta": 0,
    "totalReach": 11364,
    "tweetVelocity": 2.67,
    "engagementVelocity": 56.2,
    "momentumScore": 373.53
  }
]

This example is limited to 3 results via the limit parameter. INDEX leads the ranking with a momentumScore of 564.31, driven by a 3.67x tweet velocity and 35x engagement velocity acceleration. BDX shows the largest total reach (105,988 views) despite fewer recent tweets, while PONS rounds out the top 3 with balanced velocity and quality metrics.

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	Yes	application/vnd.cambrian.deep42.social-data.trending-momentum.v1+json
2.0.0	Current	No	application/vnd.cambrian.deep42.social-data.trending-momentum.v2+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 no Accept header is specified, the default version (1.1.0) is returned.

---

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/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.
• /deep42/social-data/influencer-credibility - Returns a direct array of cryptocurrency influencers with recent activity and historical directional-price metrics.
• /solana/trending-tokens - Retrieves a list of trending Solana tokens, ordered by price change in 24h, trade volume in 24h, or current price.