Quant Lambda
NewsAlpha EvidenceAboutAPISubscribe

Quant Lambda API

Programmatic access to news trend data for your trading bots and research tools.

Sign in to access API

API access requires a paid subscription. Sign in to check your status or subscribe.

What You Get

News Trend Data

Aggregated sentiment scores from crypto news. Each data point contains the datetime (start of interval), sentiment value (-1 to +1), and news count. The datetime represents the beginning of the time bucket (e.g., for 4h interval, 12:00:00 covers news from 12:00 to 15:59:59).

Flexible Filters

Query any time period with customizable parameters:

• interval — interval — timeframe granularity: 1h, 2h, 4h, 6h, 8h, 12h, 1d

• startDate / endDate — startDate / endDate — any date range (data available from Oct 5, 2024). Values are aligned to candle boundaries (floor for start, ceiling for end).

• coins — coins — filter by cryptocurrencies (BTC, ETH, SOL, etc.) or all coins

• newsFilter — newsFilter — news type: proactive (future events) or reactive (past analysis)

Customizable Coefficients

Fine-tune sentiment calculation with separate coefficients (0-10) for proactive/reactive news and positive/negative sentiment. Choose between weighted or count-based calculation methods.

Real-time Updates

Data refreshed every 15 minutes. Rate limit: 1 request per 10 seconds (will be increased as the project grows).

Rate Limits

Request rate1 request per 10 seconds
Max data points500 points per request
API keys1 active key per account
Data freshnessUpdated every 15 minutes
Data available fromOctober 5, 2024

Rate limits will be increased as the project develops. Contact us for higher limits.

Endpoint

GET /api/v1/trend

Headers

X-API-Key: ql_live_xxxxxxxxxxxxx

Query Parameters

ParameterTypeDescription
intervalstringTimeframe: 1h, 2h, 4h, 6h, 8h, 12h, 1d
startDatestringStart date in ISO 8601 format (e.g., 2025-01-01T00:00:00.000Z)
endDatestringEnd date in ISO 8601 format (e.g., 2025-01-22T00:00:00.000Z)
coinsstringFilter by coins (comma-separated, e.g., BTC,ETH,SOL). Default: all coins
newsFilterstringNews type: all, reactive, or proactive. Default: all
diffMethodstringCalculation method: weight (weighted average) or count (simple average). Default: weight
positiveProactivenumberCoefficient for positive proactive news (0.0 - 10.0, default: 1.0)
negativeProactivenumberCoefficient for negative proactive news (0.0 - 10.0, default: 1.0)
positiveReactivenumberCoefficient for positive reactive news (0.0 - 10.0, default: 1.0)
negativeReactivenumberCoefficient for negative reactive news (0.0 - 10.0, default: 1.0)
orderstringSort order: asc (oldest first) or desc (newest first). Default: asc
limitnumberMax points to return (max 500, default: 500)
offsetnumberNumber of points to skip for pagination (default: 0)

Understanding Coefficients

Proactive news: News about planned actions, future events, or confirmed upcoming developments.

Reactive news: Post-factum reports, opinions, discussions, and analysis of past events.

Calculation methods:

• weight: Weighted average — score × coefficient / sum of coefficients

• count: Simple average — sum of scores / news count

Response Format

{
  "success": true,
  "data": {
    "trendData": [
      {
        "datetime": "2024-10-05T00:00:00.000Z",  // ISO 8601 format
        "value": 0.45,       // sentiment score (-1 to +1)
        "newsCount": 12      // number of news items in this bucket
      },
      {
        "datetime": "2024-10-05T04:00:00.000Z",
        "value": -0.12,
        "newsCount": 8
      }
      // ... more data points
    ],
    "meta": {
      "interval": "4h",
      "alignedStartDate": "2024-10-05T00:00:00.000Z", // Input startDate aligned down to the nearest candle start (floor)
      "alignedEndDate": "2025-01-22T00:00:00.000Z",   // Input endDate aligned up to the nearest candle end (ceil)
      "totalPoints": 660,                             // Total number of candles in the aligned period
      "returnedPoints": 100,
      "offset": 0,
      "hasMore": true,
      "nextOffset": 100,
      "coins": ["BTC", "ETH"],
      "newsFilter": "all",
      "coefficients": {
        "positiveProactive": 1.0,
        "negativeProactive": 1.0,
        "positiveReactive": 1.0,
        "negativeReactive": 1.0
      },
      "diffMethod": "weight"
    }
  },
  "rateLimit": {
    "remaining": 0,
    "resetAt": 1737504010
  }
}

Example Request

curl -H "X-API-Key: ql_live_YOUR_KEY" \
  "https://quantlambda.ai/api/v1/trend?interval=4h\
&startDate=2024-10-05T00:00:00.000Z\
&endDate=2025-01-22T23:59:59.999Z\
&coins=BTC,ETH\
&newsFilter=all\
&diffMethod=weight\
&positiveProactive=1.5\
&negativeProactive=1.0\
&positiveReactive=0.8\
&negativeReactive=1.2\
&order=asc\
&limit=100\
&offset=0"
Back to Dashboard

Menu