API v1 (Legacy)
Reference
GET /timeline

GET /timeline

Historical alternative-data timeline for a ticker.

Authentication

Use the apiKey (or apikey) query parameter.

Parameters

NameTypeRequiredDescription
apiKeystringyesAPI key query parameter (case-insensitive).
symbolstringyesStock ticker symbol.
datestringnoOptional filter for a single day (YYYY-MM-DD).
datastringnoWhen set to job_posts,webtraffic, returns a reduced payload.

Behavior Notes

  • symbol is required.
  • date limits the response to a single day if present.
  • data=job_posts,webtraffic returns a smaller payload focused on job posts and web traffic.
  • reddit_sentiment is returned as an integer scaled from the stored float (value * 100).
  • Fields are omitted when data is unavailable.

Example

curl "https://api.altindex.com/timeline?apiKey=YOUR_API_KEY&symbol=TSLA"

Response Shape

{
  "status": 200,
  "id": "1",
  "name": "Tesla",
  "logo": "https://altindex.com/assets/images/tickers/TSLA.jpg",
  "domain": "tesla.com",
  "ticker": "TSLA",
  "description": "Electric vehicles and energy",
  "industry": "Autos",
  "peers": ["TM", "F", "GM"],
  "data": {
    "daily": [
      {
        "date": "2026-01-27",
        "reddit_mentions": 12,
        "reddit_sentiment": 64,
        "stocktwits_mentions": 6624,
        "stocktwits_sentiment": 59,
        "x_mentions": 2129,
        "twitter_followers": 24634907
      }
    ],
    "monthly": [
      {
        "date": "2026-01-15",
        "webtraffic": 27221000
      }
    ]
  }
}