Build with our published research

Community Analysis API

Fetch the same source-linked Reddit analysis published in our archive and RSS feed, structured as predictable JSON.

Access: Public
Authentication: None
Rate limit: 100 requests/minute/IP
Format: JSON · UTF-8

Market datasets

The market series behind this site's charts are published as CSV, one row per stored day. They need no key. Each file is measured from CoinGecko market data in this site's daily snapshots; days before recording began are not reconstructed.

Altcoin Season Index history: the daily index readings shown on Index History.
Rotation signals: the daily series behind Bitcoin dominance excluding stablecoins and the ETH/BTC ratio.

If you use the data, please cite “Altcoin Season Tracker” with a link to the page the series comes from. The calculation is described in the methodology.

One request

Quick start

Requests do not require an API key. Start with the collection endpoint to retrieve the newest published analyses.

ShellGET

curl "https://altcoinseasontracker.com/api/v1/reddit-analysis?limit=10"

Collection endpoint

List analyses

Returns published analyses in reverse chronological order. An empty archive returns an empty data array with HTTP 200.

GET/api/v1/reddit-analysis

ParameterTypeDescription

limitintegerItems to return. Default 20; minimum 1; maximum 100.

offsetintegerItems to skip. Default 0; maximum 100,000.

Detail endpoint

Get one analysis

Returns the full analysis, topics, sentiment, source discussions, article URL, and image URL for one published ID.

GET/api/v1/reddit-analysis/:id

ExampleGET

curl "https://altcoinseasontracker.com/api/v1/reddit-analysis/42"

Stable contract

Response fields

The API exposes published editorial data only. Internal generation prompts and operational fields are never returned.

Example response200 JSON

{
  "apiVersion": "1.0",
  "data": [
    {
      "id": 42,
      "date": "2026-08-13",
      "publishedAt": "2026-08-13T09:00:00.000Z",
      "title": "Market structure dominates the daily discussion",
      "summary": "A concise overview of the leading themes.",
      "analysis": "The complete published analysis...",
      "sentiment": "Mixed",
      "keyTopics": ["Bitcoin dominance", "Market structure"],
      "totalEngagement": 18420,
      "sources": [
        {
          "title": "Source discussion title",
          "url": "https://www.reddit.com/r/CryptoCurrency/...",
          "author": "u/example",
          "score": 812,
          "comments": 146,
          "publishedAt": "2026-08-13T07:30:00.000Z"
        }
      ],
      "articleUrl": "https://altcoinseasontracker.com/reddit-posts/42",
      "imageUrl": "https://altcoinseasontracker.com/images/generated/example.webp"
    }
  ],
  "pagination": {
    "count": 1,
    "total": 42,
    "limit": 1,
    "offset": 0
  },
  "links": {
    "self": "https://altcoinseasontracker.com/api/v1/reddit-analysis?limit=1&offset=0",
    "next": "https://altcoinseasontracker.com/api/v1/reddit-analysis?limit=1&offset=1",
    "previous": null
  }
}

Fair use

Rate limits and errors

The two public endpoints share a limit of 100 requests in each 60-second window for one IP address. A rejected request returns HTTP 429 and a Retry-After header.

HeaderMeaning

RateLimit-LimitMaximum requests in the window.

RateLimit-RemainingRequests remaining before rejection.

RateLimit-ResetSeconds until the window resets.

Retry-AfterSeconds to wait after HTTP 429.

400: A query parameter or ID is outside the documented range.
404: No published analysis exists for the requested ID.
429: The IP address has used all 100 requests in the current minute.