Directory of every sentiment index we have stored, with the latest reading for each.

Discovery endpoint. Returns the set of distinct `index_name` values in the `sentiment_index` table — e.g. `crypto_fear_greed`, `btc_dvol`, future alt-season / social indices — plus the most recent value and classification for each. Use it to build dropdowns or to detect when a new index ingestion goes live.

Query parameters

This endpoint takes no query parameters.

Response shape

Always wrapped in the standard envelope. Nullable fields are explicitly marked — treat missing numeric data as a real data-source gap, not as an error.

// Wrapped in the standard envelope:
// {
//   data: /* shape below */,
//   meta?: { total?: number; limit?: number; offset?: number; ... }
// }

{
  indexes: Array<{
    indexName: string;
    source: string | null;
    latestTs: number;
    latestValue: number | null;
    latestClassification: string | null;
  }>;
}

Example

Copy the curl, replace YOUR_KEY with a real key from your dashboard, and run.

curl -sS "http://localhost:3000/api/v1/sentiment/list"

{
  "data": {
    "indexes": [
      {
        "indexName": "crypto_fear_greed",
        "source": "alternative.me",
        "latestTs": 1744761600000,
        "latestValue": 62,
        "latestClassification": "Greed"
      }
    ]
  },
  "meta": { "total": 1 }
}

Notes

• Sorted alphabetically by `indexName` for stable client rendering.
• Empty `indexes` is a valid 200 on a fresh database.