v1

latestOpenAPI 3.0.02026-07-266091181.5 KB

Ticker Trends

Get Trending Tickers List

Retrieve a list of trending tickers based on various metrics. Returns securities ordered by trending score across different time intervals.

get/api/v1/trending-tickers/list

Query parameters

intervalstring required

Deprecated. Use timeframe instead. Time interval for aggregating trend data.

tickersstring

Optional comma-separated list of ticker symbols to filter results. If omitted, returns all trending tickers.

sourcestring required

Data source filter for trend calculation. Supported values: all (all sources combined), clickstream (user interaction data), logo (logo request data). Required.

timeframestring

Time interval for trend aggregation. Supported values: 10m (10 minutes), 1h (1 hour), 1d (1 day). Default: 1d

time_fromstring

Start time filter in 24-hour format (e.g., 09:15, 14:30). Use with date_from for precise time ranges.

time_tostring

End time filter in 24-hour format (e.g., 16:00, 22:30). Use with date_to for precise time ranges.

date_fromstring

Start date filter in ISO 8601 format (e.g., 2024-12-30, 2024-01-15). Use with time_from for precise ranges.

date_tostring

End date filter in ISO 8601 format (e.g., 2024-12-30, 2024-01-31). Use with time_to for precise ranges.

pageinteger

Page number for pagination. Zero-indexed (0 = first page, 1 = second page, etc.). Default: 0

pagesizeinteger

Number of results per page. Default: 1000. Maximum: 1000

Response

Ranked list of trending tickers with engagement scores

okboolean

Example response

{
  "data": [
    {
      "count": 1523,
      "pct_chg": 15,
      "security": {
        "exchange": "NASDAQ",
        "name": "Apple Inc",
        "ticker": "AAPL"
      }
    }
  ],
  "ok": true
}