Skip to main content

​
Overview

The Topics API uses advanced AI models to analyze millions of social media posts, articles, and other content sources to identify and track emerging topics in crypto. Each topic is automatically classified, summarized, and linked to relevant assets, providing a comprehensive view of the crypto narrative landscape.

​
Available Endpoints

The Topics API consists of three main endpoints:
  • Get Topic Classes - Returns all available topic classification categories (e.g., “Partnership”, “Token Listing”, “Security and Hacks”)
  • Get Global Topics - Returns currently trending topics with full details including summaries, source documents, and associated assets
  • Get Topics Timeseries - Returns historical topic data over time for trend analysis

​
Key Features

​
AI-Powered Topic Detection

Topics are automatically identified and analyzed from millions of data sources including:
  • Social media posts (X/Twitter, Reddit, etc.)
  • News articles and blog posts
  • Project announcements
  • Community discussions

​
Intelligent Classification

Each topic is automatically classified into one or more categories:
  • Project Updates: Partnership, Feature Release, Network Upgrade, Governance Update
  • Security: Protocol Exploit, Vulnerability Disclosure, Security and Hacks
  • Market Activity: Token Listing, Airdrop, Funding
  • Operations: Treasury Management, Incentives Program, Network Congestion
  • Regulatory: Legal and Regulatory, Community Update

​
Asset Association

Topics are automatically linked to relevant crypto assets, making it easy to:
  • Track all topics related to a specific asset
  • Discover which assets are involved in trending narratives
  • Monitor project-specific news and developments

​
Source Attribution

Every topic includes links to top source documents:
  • View the most influential posts and articles
  • Verify topic accuracy with primary sources
  • Understand community sentiment through direct links

​
Use Cases

The Topics API enables developers to:
  • Build Topic Monitoring Dashboards: Track trending topics in real-time and identify emerging narratives
  • Create Asset-Specific News Feeds: Show all topics related to specific assets or portfolios
  • Analyze Market Sentiment: Study topic evolution over time to understand market dynamics
  • Power Research Tools: Enable analysts to discover and investigate important crypto developments
  • Automate Alert Systems: Trigger notifications when specific topic classes emerge for monitored assets

​
Topic Lifecycle

Topics progress through different stages:
  1. Detection: AI identifies emerging clusters of related content
  2. Classification: Topics are categorized into relevant classes
  3. Summarization: AI generates comprehensive summaries with key bullet points
  4. Ranking: Topics are ranked by trending score, recency, or popularity
  5. Evolution: Topics are tracked over time as narratives develop

​
Filtering and Sorting

​
Topic Classes Filter

Control which types of topics you receive by specifying classes: 
?classes=Partnership,Token Listing,Airdrop
By default, promotional and noise categories like “Macro Commentary”, “Price Analysis”, and “Irrelevant Content” are excluded to focus on substantive developments.

​
Sort Options

  • trending: Topics sorted by momentum and recent activity (default)
  • new: Latest topics first
  • top: Topics with most source documents and engagement

​
Asset Filter

Focus on specific assets: 
?assetIDs=bitcoin,ethereum

​
Rate Limits & Best Practices

  • Current topics refresh regularly - no need to poll more frequently than once per minute
  • Historical timeseries supports up to 90 days per request
  • Use topic classes filter to reduce payload size and focus on relevant categories
  • Cache results appropriately as historical data doesn’t change

​
Authentication

All Topics API requests require authentication via the x-messari-api-key header. Visit messari.io/account/api to obtain your API key.