Skip to main content
GET
/
topics
/
v1
/
daily
Get Global Topics Timeseries
curl --request GET \
  --url https://api.messari.io/topics/v1/daily \
  --header 'x-messari-api-key: <api-key>'
{
  "error": null,
  "data": [
    {
      "time": 1759276800,
      "title": "Influencer Culture vs. Authentic Value in Crypto",
      "summary": "The cryptocurrency community is experiencing significant internal tensions between influencer culture and authentic value creation, highlighted by controversial award winners at Token2049 in Singapore and debates over education, accessibility, and the disconnect between online personas and real-world behavior. Despite these challenges, the space maintains optimism about crypto's potential to democratize finance while struggling to balance mainstream adoption with its original decentralized ethos.\n",
      "content": "• The cryptocurrency community shows significant division over influencer culture, exemplified by the controversial second consecutive \"KOL of the Year\" award win by \"Professor Crypto\" at Token2049 in Singapore, with many established community members expressing they've never heard of him despite his apparent influence, highlighting tensions between mainstream crypto adoption and the original crypto ethos.\n\n• Education and accessibility remain major challenges in cryptocurrency adoption, with multiple voices emphasizing the need for better onboarding experiences and simplified tools to help newcomers understand the technology, risks, and opportunities without requiring extensive technical knowledge.\n\n• A notable disconnect exists between online crypto personas and real-world behavior, with several observations about how crypto conferences and events reveal the gap between carefully crafted social media images and the actual personalities behind them, sometimes leading to disillusionment among attendees.\n\n• Personal experiences in cryptocurrency vary dramatically, from stories of significant financial gains and lifestyle changes to frustrations with market volatility and family skepticism, reflecting the emotional rollercoaster many participants experience in the space.\n\n• Despite criticisms of scams, volatility, and regulatory uncertainty, there remains a persistent optimism about cryptocurrency's potential to solve real-world problems and create opportunities for those willing to engage with the technology, with several mentions of how crypto provides financial access regardless of background.\n\n• The cryptocurrency space continues to struggle with its identity, caught between becoming more mainstream and accessible while maintaining the technical meritocracy and decentralized ethos that attracted early adopters, creating ongoing tension between different visions for the industry's future.\n",
      "classes": [
        "Macro Commentary"
      ],
      "topDocuments": [
        {
          "url": "https://x.com/juanaxyz00/status/1973155214330110110",
          "type": "x_post"
        },
        {
          "url": "https://x.com/realfrankwilder/status/1973091448871330121",
          "type": "x_post"
        },
        {
          "url": "https://x.com/azeemk_/status/1972927983015928065",
          "type": "x_post"
        }
      ],
      "rank": 1,
      "documentCount": 765,
      "assets": null
    },
    {
      "time": 1759276800,
      "title": "Bitcoin Breaks $117K as Durov Predicts $1M Future",
      "summary": "Bitcoin surpassed $117,000 on October 1, 2025, kicking off \"Uptober\" with strong momentum after closing September up 5.16%. Telegram founder Pavel Durov made headlines predicting Bitcoin will eventually reach $1,000,000, while CryptoQuant analysts project potential Q4 targets of $160,000-$200,000 if demand continues, supported by Bitcoin's historically strong performance in October.\n",
      "content": "• Bitcoin surpassed $117,000 on October 1, 2025, marking a strong start to \"Uptober\" with a market cap of approximately $2.32 trillion and 24-hour trading volume exceeding $94 billion, after closing September up 5.16% at $114,065.\n\n• Telegram founder Pavel Durov made headlines predicting Bitcoin will eventually reach $1,000,000, citing government money printing and Bitcoin's fixed supply as key factors. Durov revealed he's owned Bitcoin since it was $750 and stated \"I am not going to sell it.\"\n\n• CryptoQuant analysts project Bitcoin could reach $160,000-$200,000 in Q4 2025 if current demand continues, while other analysts target $148,000+ for October, noting that historically Bitcoin has been green in 9 of the last 10 Octobers.\n\n• Technical analysis identifies $117,000-$118,000 as critical resistance levels, with traders suggesting a breakthrough could quickly propel Bitcoin toward $120,000, while the Bitcoin Fear and Greed Index remains neutral at 49-50.\n\n• Historical context shows Bitcoin's dramatic growth, trading at just $27,000 exactly two years prior, with Q4 historically delivering average returns of 85% and median returns of 52%, fueling optimism for the remainder of 2025.\n",
      "classes": [
        "Price Analysis"
      ],
      "topDocuments": [
        {
          "url": "https://x.com/25THPRMR/status/1973309789569687832",
          "type": "x_post"
        },
        {
          "url": "https://x.com/ProofOfTravis/status/1973389530846646405",
          "type": "x_post"
        },
        {
          "url": "https://x.com/wallstreetbets/status/1973385236965892601",
          "type": "x_post"
        }
      ],
      "rank": 2,
      "documentCount": 305,
      "assets": [
        {
          "id": "21c795f5-1bfd-40c3-858e-e9d7e820c6d0",
          "name": "Ethereum",
          "symbol": "ETH",
          "slug": "ethereum"
        }
      ]
    }
  ]
}

​
Overview

Retrieve historical timeseries data for trending topics. This endpoint allows you to analyze how topics evolved over time, track when topics first appeared, and understand historical narrative trends in the crypto ecosystem.

​
Query Parameters

​
start (required)

Start of the time range in ISO 8601 format. Example: ?start=2025-01-01T00:00:00Z

​
end (required)

End of the time range in ISO 8601 format. Example: ?end=2025-01-07T23:59:59Z

​
granularity

Time interval for data points:
  • 1d (default): Daily data points
  • 1h: Hourly data points
Example: ?granularity=1d

​
Time Range Limits

  • Maximum range: 90 days
  • Default range: 7 days (if not specified)
  • Ranges are automatically truncated to granularity boundaries for better caching

​
Response Structure

Each data point in the timeseries includes:
  • time: Unix timestamp of the data point
  • title: Topic title
  • summary: Topic summary
  • content: Detailed content with bullet points
  • classes: Array of classification tags
  • rank: Ranking of the topic at this timestamp (1 = most trending)
  • topDocuments: Links to source documents
    • url: Document URL
    • type: Document type (x_post, article, etc.)
  • documentCount: Number of source documents
  • assets: Array of related crypto assets
    • id: Asset UUID
    • name: Asset name
    • symbol: Asset symbol
    • slug: Asset slug

​
Usage Examples

​
Get Daily Topics for a Week

curl -X GET "https://api.messari.io/topics/v1/daily?start=2025-01-01T00:00:00Z&end=2025-01-07T23:59:59Z&granularity=1d" \
  -H "x-messari-api-key: YOUR_API_KEY"

​
Get Hourly Topics for 24 Hours

curl -X GET "https://api.messari.io/topics/v1/daily?start=2025-01-01T00:00:00Z&end=2025-01-02T00:00:00Z&granularity=1h" \
  -H "x-messari-api-key: YOUR_API_KEY"

​
Analysis Use Cases

​
Track Topic Persistence

Identify which topics stay relevant over extended periods vs. flash-in-the-pan news.

​
Analyze Topic Classes Over Time

See how different types of topics (security, partnerships, etc.) trend seasonally.

​
Monitor Asset Narratives

Track how often specific assets appear in trending topics over time.

​
Detect Narrative Shifts

Identify when new topics emerge or old topics fade from attention.

​
Compare Time Periods

Analyze how topic landscape differs between bull and bear markets.

​
Best Practices

  1. Use Appropriate Granularity: Daily for long-term trends, hourly for real-time analysis
  2. Respect Time Limits: Don’t request more than 90 days at once
  3. Handle Empty Results: Some time periods may have no trending topics
  4. Cache Historical Data: Past data doesn’t change, cache it locally
  5. Batch Requests: For large date ranges, break into multiple smaller requests

​
Response Format

Topics are sorted by:
  1. Timestamp (ascending)
  2. Trending score (descending - higher ranks first)
This means for each timestamp, you’ll see the most important topics first.

​
Error Handling

Common errors:
  • 400 Bad Request: Invalid date format or time range exceeds 90 days
  • 403 Forbidden: Insufficient API permissions
  • 500 Internal Server Error: Temporary service issue, retry with backoff

Authorizations

​
x-messari-api-key
string
header
required

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

Query Parameters

​
start
string<date-time>
default:2025-10-01T00:00:00Z
required

Start of time range in ISO 8601 format

Example:

"2025-10-01T00:00:00Z"

​
end
string<date-time>
default:2025-10-03T23:59:59Z
required

End of time range in ISO 8601 format

Example:

"2025-10-03T23:59:59Z"

​
granularity
enum<string>
default:1d

Time granularity for data points

Available options:
1d,
1h

Response

Successfully retrieved topics timeseries

​
error
string | null
​
data
object[]