Skip to main content
GET
Get Current Topics

Overview

Retrieve today’s trending topics in the crypto ecosystem. This endpoint returns a snapshot of topics that are actively trending right now, refreshed throughout the day. Each topic includes a title, AI-generated summary, detailed content with bullet points, associated assets, source documents, and classification tags. For historical topic data, use the Get Topics Timeseries endpoint.

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
Use the Get Topic Classes endpoint to see all available classes.

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
Example: ?sort=new

assetIDs

Filter topics by associated assets. Provide a comma-separated list of asset identifiers. Accepts any combination of UUIDs, slugs, or symbols. Examples:
  • By slug: ?assetIDs=bitcoin,ethereum,solana
  • By symbol: ?assetIDs=BTC,ETH,SOL
  • By UUID: ?assetIDs=21c795f5-1bfd-40c3-858e-e9d7e820c6d0
  • Mixed: ?assetIDs=bitcoin,ETH,21c795f5-1bfd-40c3-858e-e9d7e820c6d0

page

Page number for paginated results (1-indexed). Defaults to 1. Example: ?page=2

limit

Number of topics per page. Defaults to 1000. Example: ?limit=25

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

Filter by Topic Classes

Get Topics for Specific Assets (by slug)

Get Topics for Specific Assets (by symbol)

Sort by Newest Topics

Paginate Results

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
  • page: Current page number
  • pageSize: Number of topics per page
  • totalRows: Total number of matching topics
  • totalPages: Total number of pages available

Best Practices

  1. Use Class Filters: Reduce response size and noise by filtering to relevant classes
  2. Check Source Documents: Verify topic accuracy by reviewing topDocuments
  3. Monitor Asset Activity: Track topics for your portfolio assets using assetIDs filter
  4. Rate Limit Considerations: Topics refresh regularly, avoid polling more than once per minute
  5. Paginate Large Responses: Use page and limit to reduce response size and improve performance
  6. 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

x-messari-api-key
string
header
required

API key for authentication. Get your key at https://messari.io/account/api

Query Parameters

classes
enum<string>[]

Comma-separated list of topic classes to include. Use /topics/v1/classes to see all available classes.

Available options:
Treasury Management,
Treasury Expense,
Project Team Funding,
Incentives Program,
Discontinued Product,
Project Strategy,
Partnership,
Token Swap or Migration,
Network Upgrade,
Governance Update,
Project Announcements,
Network Deployment,
Airdrop,
Feature Release,
Network Launch,
Token Listing,
Security and Hacks,
Protocol Exploit,
Vulnerability Disclosure,
Centralized Exchange Loss of Funds,
Funding,
Legal and Regulatory,
Network Congestion,
Blockchain Halt,
Node Outage,
Bug Disclosure,
Chain Split,
Community Update,
Macro Commentary,
Price Analysis,
Irrelevant Content
sort
enum<string>
default:trending

Desired sort order of topics

Available options:
trending,
new,
top
assetIDs
string

Comma-separated list of asset identifiers to filter topics by associated assets. Accepts UUIDs, slugs, or symbols.

Example:

"bitcoin,ETH,21c795f5-1bfd-40c3-858e-e9d7e820c6d0"

page
integer<int64>
default:1

Page number (1-indexed)

Required range: x >= 1
limit
integer<int64>
default:1000

Number of topics per page

Response

Successfully retrieved topics

error
string | null
data
object[]
metadata
object