Narratives

The Narratives API returns trending narratives in the creator ecosystem, with historical momentum tracking. Use it to identify emerging themes and topics before they peak.

List narratives

GET /v1/narratives

Returns trending narratives, ordered by momentum score.

Query parameters

Parameter	Type	Description
ecosystem	string	Filter by ecosystem (e.g., base, solana)
category	string	Filter by category
period	string	Trend window: 24h, 7d, 30d. Default: 7d
limit	integer	Results per page. Default: 20, max: 50

Example response

{
  "data": [
    {
      "id": "nar_001",
      "label": "AI agents on-chain",
      "momentum_score": 94.2,
      "momentum_trend": "rising",
      "mention_count_7d": 4820,
      "mention_count_change_pct": 38.4,
      "top_platforms": ["x", "tiktok"],
      "related_projects": ["prj_xyz789"]
    }
  ]
}

Get a narrative

GET /v1/narratives/{id}

Returns the full profile for a narrative including historical momentum data.

Example response

{
  "data": {
    "id": "nar_001",
    "label": "AI agents on-chain",
    "momentum_score": 94.2,
    "momentum_trend": "rising",
    "history": [
      { "date": "2026-05-01", "mention_count": 620, "momentum_score": 78.1 },
      { "date": "2026-05-02", "mention_count": 890, "momentum_score": 85.4 },
      { "date": "2026-05-03", "mention_count": 1240, "momentum_score": 94.2 }
    ],
    "top_contributors": ["ctr_abc123", "ctr_def456"],
    "related_projects": ["prj_xyz789"]
  }
}

Momentum scores

Momentum scores (0–100) reflect the velocity and acceleration of a narrative, not just its raw volume. A score of 90+ indicates a narrative growing significantly faster than baseline activity in that category.