Overview
Retrieve currently trending topics in the crypto ecosystem. Each topic includes a title, AI-generated summary, detailed content with bullet points, associated assets, source documents, and classification tags.Query Parameters
classes
Filter topics by classification categories. Provide a comma-separated list of topic classes. Example:?classes=Partnership,Token Listing,Airdrop
By default, the following classes are excluded to reduce noise:
- Macro Commentary
 - Price Analysis
 - Irrelevant Content
 
sort
Control the order of returned topics:- trending (default): Topics ranked by momentum and recent activity
 - new: Most recently detected topics first
 - top: Topics with the most source documents and engagement
 
?sort=new
assetIDs
Filter topics by associated assets. Provide comma-separated asset slugs or UUIDs. Example:?assetIDs=bitcoin,ethereum,solana
Response Structure
Each topic in the response includes:- title: Concise topic title
 - summary: 1-2 paragraph summary of the topic
 - content: Detailed bullet-point breakdown of key information
 - rank: Numerical ranking of the topic
 - classes: Array of classification tags
 - topDocuments: Links to the most influential source documents
- url: Link to the source (X post, article, etc.)
 - type: Document type (x_post, article, etc.)
 
 - documentCount: Total number of source documents analyzed
 - avgDocumentTimestamp: Average timestamp of source documents
 - assets: Array of related crypto assets
- id: Asset UUID
 - name: Asset full name
 - symbol: Asset ticker symbol
 - slug: Asset URL slug
 
 
Usage Examples
Get All Trending Topics
Filter by Topic Classes
Get Topics for Specific Assets
Sort by Newest Topics
Response Metadata
The response includes metadata about the results:- snapshotTime: When the topics snapshot was generated
 - includedClasses: Which topic classes were included in the results
 
Best Practices
- Use Class Filters: Reduce response size and noise by filtering to relevant classes
 - Check Source Documents: Verify topic accuracy by reviewing topDocuments
 - Monitor Asset Activity: Track topics for your portfolio assets using assetIDs filter
 - Rate Limit Considerations: Topics refresh regularly, avoid polling more than once per minute
 - Combine Filters: Use multiple filters together for precise results
 
Common Use Cases
- Build a Crypto News Feed: Display trending topics as a news dashboard
 - Asset Monitoring: Track all developments for specific assets in your portfolio
 - Security Alerts: Monitor for “Protocol Exploit” and “Security and Hacks” classes
 - Partnership Tracking: Discover new collaborations and strategic moves
 - Market Intelligence: Analyze which topics are gaining traction
 
Authorizations
API key for authentication. Get your key at https://messari.io/account/api
Query Parameters
Comma-separated list of topic classes to include. Use /topics/v1/classes to see all available classes.
Desired sort order of topics
Available options: 
trending, new, top Comma-separated list of asset IDs or slugs to filter topics by associated assets
Example:
"bitcoin,ethereum"

