Cambrian Detect trending tokens with social momentum API

By Cambrian Network deep42

GET /api/v1/deep42/social-data/trending-momentum

Trending Momentum

Overview

Detects tokens with rapidly increasing social signals by measuring the rate of change in tweet volume, engagement, and quality. It returns a composite momentum score that highlights tokens accelerating in social attention, either as a single aggregate ranking or as a time series of momentum changes across time buckets.

Business Value

  • Early Market Detection: Identify tokens gaining social traction before mainstream adoption, providing alpha opportunities for traders and analysts
  • Social Sentiment Analysis: Track sentiment changes and social momentum patterns to gauge market mood and potential price movements
  • Risk Assessment: Use quality scores and author diversity metrics to evaluate the authenticity and reliability of social signals
  • Portfolio Optimization: Incorporate social momentum data into trading strategies to enhance timing and position sizing decisions
  • Trend Validation: Confirm technical analysis signals with social momentum indicators for more robust trading decisions

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 (min 1, max 168)
min_velocity number No 0.3 Minimum velocity score (rate of change)
limit integer No 15 Number of trending tokens to return (max 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 (max 1000 rows)

Response Field Descriptions

Response Field Type Description
tokenSymbol String Token symbol
recentTweets Integer Recent tweet count in the lookback window
uniqueAuthors Integer Number of unique authors discussing this token
sentiment Number Average sentiment score. Range 0-10. 0 = very bearish, 5 = neutral, 10 = very bullish
qualityScore Number Average quality of tweets based on author credibility and content depth. Range 0-10. >7 = high quality
qualityDelta Number Change in quality score relative to the prior period
totalReach Integer Total views across all tweets in the window
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
momentumScore Number Composite momentum score combining velocity, volume, and quality. Unbounded, typically 0-100. >10 = trending, >50 = viral momentum

Examples

1. Default Aggregate Momentum Ranking

Fetches the top trending tokens by composite momentum score over the default 24-hour lookback window, using the default total granularity.

curl -X GET "https://api.cambrian.org/deep42/social-data/trending-momentum" \
  -H "X-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response:

[
  {
    "tokenSymbol": "HOME",
    "recentTweets": 10,
    "uniqueAuthors": 8,
    "sentiment": 7.3,
    "qualityScore": 14.5,
    "qualityDelta": 0.5,
    "totalReach": 43354,
    "tweetVelocity": 3.25,
    "engagementVelocity": 32.9,
    "momentumScore": 503.16
  },
  {
    "tokenSymbol": "STX",
    "recentTweets": 7,
    "uniqueAuthors": 6,
    "sentiment": 8.71,
    "qualityScore": 16,
    "qualityDelta": 1,
    "totalReach": 6887,
    "tweetVelocity": 2.5,
    "engagementVelocity": 25.71,
    "momentumScore": 353.5
  },
  {
    "tokenSymbol": "SEI",
    "recentTweets": 4,
    "uniqueAuthors": 3,
    "sentiment": 7.5,
    "qualityScore": 14.75,
    "qualityDelta": 0,
    "totalReach": 20386,
    "tweetVelocity": 2.33,
    "engagementVelocity": 54.5,
    "momentumScore": 341.5
  },
  {
    "tokenSymbol": "LINK",
    "recentTweets": 27,
    "uniqueAuthors": 20,
    "sentiment": 8.48,
    "qualityScore": 16.07,
    "qualityDelta": 0.79,
    "totalReach": 114420,
    "tweetVelocity": 1.76,
    "engagementVelocity": 60.04,
    "momentumScore": 330.4
  },
  {
    "tokenSymbol": "SATUSD",
    "recentTweets": 3,
    "uniqueAuthors": 3,
    "sentiment": 9,
    "qualityScore": 16,
    "qualityDelta": 0,
    "totalReach": 11156,
    "tweetVelocity": 2,
    "engagementVelocity": 78.67,
    "momentumScore": 298.23
  },
  {
    "tokenSymbol": "HEI",
    "recentTweets": 3,
    "uniqueAuthors": 3,
    "sentiment": 8.67,
    "qualityScore": 16,
    "qualityDelta": 0,
    "totalReach": 7081,
    "tweetVelocity": 2,
    "engagementVelocity": 22,
    "momentumScore": 283.69
  },
  {
    "tokenSymbol": "DOGE",
    "recentTweets": 5,
    "uniqueAuthors": 5,
    "sentiment": 5.6,
    "qualityScore": 12.8,
    "qualityDelta": -3.2,
    "totalReach": 54726,
    "tweetVelocity": 2,
    "engagementVelocity": 110,
    "momentumScore": 279.3
  },
  {
    "tokenSymbol": "RENDER",
    "recentTweets": 6,
    "uniqueAuthors": 5,
    "sentiment": 8.83,
    "qualityScore": 16.17,
    "qualityDelta": 0.17,
    "totalReach": 5350,
    "tweetVelocity": 1.8,
    "engagementVelocity": 28.33,
    "momentumScore": 249.82
  },
  {
    "tokenSymbol": "TRX",
    "recentTweets": 3,
    "uniqueAuthors": 3,
    "sentiment": 8.33,
    "qualityScore": 15.33,
    "qualityDelta": 0,
    "totalReach": 2890,
    "tweetVelocity": 2,
    "engagementVelocity": 11,
    "momentumScore": 244.39
  },
  {
    "tokenSymbol": "RLUSD",
    "recentTweets": 6,
    "uniqueAuthors": 6,
    "sentiment": 8.33,
    "qualityScore": 15.5,
    "qualityDelta": 1,
    "totalReach": 5996,
    "tweetVelocity": 1.8,
    "engagementVelocity": 15,
    "momentumScore": 242.7
  }
]

HOME leads the ranking with a momentum score of 503.16, driven by a 3.25x tweet velocity and 32.9x engagement velocity spike relative to the prior window — a strong signal of accelerating social attention.

2. Daily Time-Series Granularity

Requests momentum data with granularity=1d and limit=5 to view daily momentum evolution instead of a single aggregate ranking.

curl -X GET "https://api.cambrian.org/deep42/social-data/trending-momentum?granularity=1d&limit=5" \
  -H "X-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response:

[
  {
    "tokenSymbol": "LINK",
    "recentTweets": 0,
    "uniqueAuthors": 7,
    "sentiment": 8.44,
    "qualityScore": 16.11,
    "qualityDelta": 0,
    "totalReach": 68953,
    "tweetVelocity": 9,
    "engagementVelocity": 4.64,
    "momentumScore": 154.99
  },
  {
    "tokenSymbol": "INJ",
    "recentTweets": 0,
    "uniqueAuthors": 1,
    "sentiment": 8.25,
    "qualityScore": 15.63,
    "qualityDelta": 0,
    "totalReach": 314,
    "tweetVelocity": 8,
    "engagementVelocity": 3.94,
    "momentumScore": 125.08
  },
  {
    "tokenSymbol": "BTC",
    "recentTweets": 0,
    "uniqueAuthors": 6,
    "sentiment": 5.17,
    "qualityScore": 12.33,
    "qualityDelta": 0,
    "totalReach": 8864,
    "tweetVelocity": 6,
    "engagementVelocity": 22.6,
    "momentumScore": 74.64
  }
]

With daily granularity, tweetVelocity compares each day's tweet count to the previous day rather than a single aggregate window, so tokens like LINK show a 9x day-over-day tweet velocity even with fewer tokens recorded as "recent" in this particular slice.

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/api/v1/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/api/v1/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.1.0 Current Yes application/vnd.cambrian.deep42.social-data.trending-momentum.v1+json
1.0.0 Current No application/vnd.cambrian.deep42.social-data.trending-momentum.v1+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

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