Get Global Topics Timeseries
curl --request GET \
--url https://api.messari.io/topics/v1/daily \
--header 'x-messari-api-key: <api-key>'import requests
url = "https://api.messari.io/topics/v1/daily"
headers = {"x-messari-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-messari-api-key': '<api-key>'}};
fetch('https://api.messari.io/topics/v1/daily', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.messari.io/topics/v1/daily",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-messari-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.messari.io/topics/v1/daily"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-messari-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.messari.io/topics/v1/daily")
.header("x-messari-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.messari.io/topics/v1/daily")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-messari-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"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"
}
]
}
]
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}Topics API
Get Topics Timeseries
Retrieve a timeseries of global topics over a specified time range. Returns historical topic data with rankings and associated metadata. Maximum range is 90 days.
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>'import requests
url = "https://api.messari.io/topics/v1/daily"
headers = {"x-messari-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-messari-api-key': '<api-key>'}};
fetch('https://api.messari.io/topics/v1/daily', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.messari.io/topics/v1/daily",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-messari-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.messari.io/topics/v1/daily"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-messari-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.messari.io/topics/v1/daily")
.header("x-messari-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.messari.io/topics/v1/daily")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-messari-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"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"
}
]
}
]
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}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
?granularity=1d
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
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"
Get Daily Topics for Specific Assets
curl -X GET "https://api.messari.io/topics/v1/daily?start=2025-01-01T00:00:00Z&end=2025-01-07T23:59:59Z&assetIDs=bitcoin,ethereum" \
-H "x-messari-api-key: YOUR_API_KEY"
Filter by Asset Symbol
curl -X GET "https://api.messari.io/topics/v1/daily?start=2025-01-01T00:00:00Z&end=2025-01-07T23:59:59Z&assetIDs=BTC,ETH" \
-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. Use theassetIDs filter to focus on assets in your portfolio.
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
- Use Appropriate Granularity: Daily for long-term trends, hourly for real-time analysis
- Respect Time Limits: Don’t request more than 90 days at once
- Handle Empty Results: Some time periods may have no trending topics
- Cache Historical Data: Past data doesn’t change, cache it locally
- Batch Requests: For large date ranges, break into multiple smaller requests
Response Format
Topics are sorted by:- Timestamp (ascending)
- Trending score (descending - higher ranks 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
API key for authentication. Get your key at https://messari.io/account/api
Query Parameters
Start of time range in ISO 8601 format
Example:
"2025-10-01T00:00:00Z"
End of time range in ISO 8601 format
Example:
"2025-10-03T23:59:59Z"
Time granularity for data points
Available options:
1d, 1h 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"

