{ "openapi": "3.0.0", "info": { "description": "The Topics API provides access to AI-analyzed trending topics in crypto, including global topics, topic classes, and historical timeseries data.", "title": "Messari API - Topics V1", "version": "1.0.0" }, "servers": [ { "description": "Messari Topics API", "url": "https://api.messari.io" } ], "security": [ { "ApiKeyAuth": [] } ], "paths": { "/topics/v1/classes": { "get": { "description": "Retrieve a list of all available topic classes. Topic classes categorize topics into themes like 'Partnership', 'Security and Hacks', 'Token Listing', etc.", "operationId": "getTopicClassesV1", "tags": [ "Topics" ], "summary": "Get Topic Classes", "responses": { "200": { "description": "Successfully retrieved topic classes", "content": { "application/json": { "schema": { "properties": { "error": { "type": "string", "nullable": true }, "data": { "type": "array", "items": { "type": "string" } } }, "type": "object" }, "example": { "error": null, "data": [ "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" ] } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "403": { "$ref": "#/components/responses/Forbidden" }, "500": { "$ref": "#/components/responses/InternalServerError" } } } }, "/topics/v1/current": { "get": { "description": "Retrieve today's trending topics. Returns a snapshot of topics that are actively trending right now, refreshed throughout the day. Topics can be filtered by class and sorted by different criteria. Each topic includes a title, summary, detailed content, rank, associated assets, and top source documents.", "operationId": "getCurrentTopicsV1", "tags": [ "Topics" ], "summary": "Get Current Topics", "parameters": [ { "name": "classes", "in": "query", "description": "Comma-separated list of topic classes to include. Use /topics/v1/classes to see all available classes.", "schema": { "type": "array", "items": { "type": "string", "enum": [ "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" ] } }, "style": "form", "explode": false, "example": "Partnership,Token Listing,Airdrop" }, { "name": "sort", "in": "query", "description": "Desired sort order of topics", "schema": { "type": "string", "enum": [ "trending", "new", "top" ], "default": "trending" } }, { "name": "assetIDs", "in": "query", "description": "Comma-separated list of asset identifiers to filter topics by associated assets. Accepts UUIDs, slugs, or symbols.", "schema": { "type": "string", "example": "bitcoin,ETH,21c795f5-1bfd-40c3-858e-e9d7e820c6d0" } }, { "name": "page", "in": "query", "description": "Page number (1-indexed)", "schema": { "type": "integer", "format": "int64", "minimum": 1, "default": 1 } }, { "name": "limit", "in": "query", "description": "Number of topics per page", "schema": { "type": "integer", "format": "int64", "default": 1000 } } ], "responses": { "200": { "description": "Successfully retrieved topics", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TopicsResponse" }, "example": { "error": null, "data": [ { "title": "Warden Protocol's $900K Mindshare Leaderboard Launch", "summary": "Warden Protocol has launched a $900,000 rewards campaign called the Mindshare Leaderboard on Wallchain, distributing $WARD tokens across four epochs to top contributors. This \"grand finale\" before their Token Generation Event rewards content creators and educators who demonstrate understanding of Warden's Global Agent Network, which functions as an operating system for AI agents in the crypto ecosystem.\n", "content": "\u2022 Warden Protocol has launched its Mindshare Leaderboard on Wallchain with a massive $900,000 in $WARD token rewards distributed across four epochs, with Epoch 1 starting November 3, 2025, offering $250,000 to the top 225 contributors plus 25 random participants from ranks 226-500.\n\n\u2022 Positioned as the \"Global Agent Network,\" Warden Protocol is building an operating system for intelligent, interconnected crypto, functioning as an AI Layer-1 on Cosmos that enables agents to think, act, and collaborate across the ecosystem, with a reported user base of 8.5 million and over 300,000 daily active users.\n\n\u2022 The campaign represents the \"grand finale\" before Warden's Token Generation Event (TGE), with all rewards being fully unlocked at TGE without vesting periods, incentivizing content creation, education, and ecosystem engagement rather than mere hype.\n\n\u2022 Participants can earn rewards by creating high-quality content about Warden, sharing insights, and demonstrating real understanding of the protocol, with Wallchain's AI measuring contributors' genuine influence and impact within the ecosystem.\n\n\u2022 The DCA (Dollar Cost Average) Agent is now live on the Warden app, allowing users to schedule automated investment rules (like \"Invest $50 in BTC every week\") while earning \"Pumps\" that count toward the $WARD airdrop, showcasing practical utility within the Warden ecosystem.\n", "rank": 1, "classes": [ "Promotional Content", "Incentives Program" ], "topDocuments": [ { "url": "https://x.com/BullishRisker/status/1985348383490572744", "type": "x_post" }, { "url": "https://x.com/oneboyinafrica/status/1985332549975986301", "type": "x_post" }, { "url": "https://x.com/Crypto_unicat/status/1985359545183650011", "type": "x_post" }, { "url": "https://x.com/luisvae/status/1985357503983436077", "type": "x_post" }, { "url": "https://x.com/AviiWeb3/status/1985355320621932793", "type": "x_post" } ], "documentCount": 804, "avgDocumentTimestamp": "2025-11-03T14:33:50.689054726Z", "assets": [ { "id": "75b7308f-6790-4d41-be79-7a2b658daad1", "name": "Warden Protocol", "symbol": "WARD", "slug": "warden-protocol" } ] }, { "title": "Wallchain's Quack Rewards System", "summary": "Wallchain is a social engagement platform that rewards users with \"Quacks\" for creating valuable crypto content, evaluated by an AI model that measures impact rather than simple engagement metrics. Users earn Quacks by discussing specific cryptocurrency projects like idOS, Klout, and Beyond, with the platform featuring gamification elements such as leaderboards, achievement tiers, and badges, while an upcoming Genesis NFT release generates community excitement.\n", "content": "\u2022 Wallchain is a social media engagement platform that rewards users with \"Quacks\" for creating valuable and insightful content, particularly about cryptocurrency projects. Users regularly share their daily Quack earnings, which typically range from fractions of a point to around 20 Quacks per day, with many following a template: \"Just earned X.XX Quacks on @wallchain in one day \ud83e\udd86.\"\n\n\u2022 The platform evaluates content quality using a custom large language model (LLM) that measures impact rather than just engagement metrics. As one user described it: \"While most measure bots & clicks, Wallchain measures impact. If your posts aren't shifting the chain, your score won't either.\" This creates a system where \"your thoughts are assets\" and \"your engagement is proof of work.\"\n\n\u2022 Users earn Quacks primarily by engaging with specific cryptocurrency projects, with @idOS_network (a portable identity solution), @kloutgg, @beyond__tech, and @HeyElsaAI being the most frequently mentioned. Projects run campaigns with reward pools, such as Covalent's \"$200K CXT rewards pool\" and various \"Epochs\" where top performers on leaderboards can earn token allocations.\n\n\u2022 The Wallchain ecosystem includes gamification elements like leaderboards, achievement tiers (from F tier at 10+ Quacks to S tier at 6000+ Quacks), and badges such as \"Early Quacker.\" Users actively track their progress, celebrate milestones, and share strategies for earning more Quacks, including posting quality content, being a \"reply guy,\" and consistently engaging with specific projects.\n\n\u2022 An upcoming Genesis NFT release appears to be generating excitement in the community, with speculation that early participation and badges might provide advantages. Users frequently share referral links to grow the network, creating a community-driven growth model where participants actively support each other to increase their Quack earnings.\n", "rank": 2, "classes": [ "Incentives Program", "Promotional Content" ], "topDocuments": [ { "url": "https://x.com/AirdropDuyuru/status/1985336418982400263", "type": "x_post" }, { "url": "https://x.com/manyaaww/status/1985312235582116127", "type": "x_post" }, { "url": "https://x.com/GoIdenAgent/status/1985039970860724347", "type": "x_post" }, { "url": "https://x.com/GucciSpinal/status/1985075273080205600", "type": "x_post" }, { "url": "https://x.com/itzdezydank/status/1985359061483655218", "type": "x_post" } ], "documentCount": 850, "avgDocumentTimestamp": "2025-11-03T11:51:17.283529412Z", "assets": [ { "id": "53b88720-1a0d-4fbc-9245-3f5e20d88fe1", "name": "NOME", "symbol": "nome", "slug": "nome" } ] }, { "title": "CZ's ASTER Purchase Triggers Market Surge", "summary": "Binance founder Changpeng Zhao's $2 million purchase of ASTER tokens in November 2025 caused a 20-40% price surge, demonstrating his continued market influence despite recent controversies. The announcement marked a rare public disclosure of a personal investment by CZ, who previously only acknowledged owning BTC and BNB, while simultaneously facing scrutiny over a presidential pardon and his involvement in a separate token controversy involving Giggle.\n", "content": "\u2022 Changpeng Zhao (CZ), Binance's founder, publicly disclosed purchasing $2 million worth of ASTER tokens in November 2025, stating \"I am not a trader. I buy and hold.\" This announcement is particularly significant as CZ has historically only publicly acknowledged owning BTC and BNB, causing ASTER's price to surge 20-40% within hours of his disclosure.\n\n\u2022 The crypto community's reaction to CZ's ASTER purchase was mixed \u2013 many viewed it as a strong bullish signal given CZ's track record with BNB (which reportedly grew from $0.1 to $1,400), while others questioned the ethics of such market-moving announcements and suggested potential market manipulation, with some users reporting liquidations following the rapid price movement.\n\n\u2022 A separate incident involving Binance occurred when CZ, current Binance CEO Richard Teng, and official Binance accounts posted about Giggle token, causing a price surge. However, CZ later clarified it wasn't an official token, triggering a sharp market drop, with Binance subsequently announcing a 50% fee donation to the Giggle Fund.\n\n\u2022 Political controversy surrounds CZ as President Trump pardoned him despite his guilty plea for anti-money laundering violations and a four-month sentence. In a 60 Minutes interview, Trump claimed not to know who CZ is despite issuing the pardon, drawing criticism from lawmakers including Senator Elizabeth Warren who characterized it as a conflict of interest.\n\n\u2022 Beyond token announcements, the content reveals CZ's expanding influence beyond Binance, with references to his involvement in launching Bereketh Bank in Kyrgyzstan, highlighting his continued impact on global financial systems despite his legal challenges.\n", "rank": 3, "classes": [ "Price Analysis", "Legal and Regulatory", "Macro Commentary" ], "topDocuments": [ { "url": "https://x.com/cz_binance/status/1984992347395141987", "type": "x_post" }, { "url": "https://x.com/0xleegenz/status/1985013624583417937", "type": "x_post" }, { "url": "https://x.com/coinbureau/status/1984997694214160629", "type": "x_post" }, { "url": "https://x.com/blocknewsdotcom/status/1985036816710586680", "type": "x_post" }, { "url": "https://x.com/realkaicrypto/status/1985173557547311439", "type": "x_post" } ], "documentCount": 247, "avgDocumentTimestamp": "2025-11-03T00:57:49.728744939Z", "assets": [ { "id": "7dc551ba-cfed-4437-a027-386044415e3e", "name": "BNB", "symbol": "BNB", "slug": "binance-coin" }, { "id": "41bdaf1e-5fa8-4a61-a3c3-5a7ecea463f2", "name": "Changpeng Zhao", "symbol": "cz", "slug": "changpeng-zhao" } ] }, { "title": "Ripple's Institutional Expansion and XRP ETF Launch", "summary": "XRP is experiencing significant institutional developments with spot ETFs expected to launch by mid-November 2025 following the resolution of Ripple's SEC case, while Ripple expands its business model by launching prime brokerage services in the US market. Despite a recent price decline to the $2.40-2.65 range, the ecosystem continues to grow with increasing DeFi integration and utility for cross-border settlements.\n", "content": "\u2022 Spot XRP ETFs are expected to launch around November 13, 2025, with Canary Capital leading the charge after the SEC's five-year litigation against Ripple concluded in August 2025, clearing regulatory hurdles for approval. Industry executives project these ETFs could attract $1-5 billion in investments within the first months of trading.\n\n\u2022 Ripple has expanded beyond payments by launching digital-asset spot prime brokerage services in the United States, allowing clients to execute OTC transactions across major digital assets and stablecoins, including XRP and RLUSD. This strategic move positions Ripple as a more comprehensive financial services provider in the cryptocurrency space.\n\n\u2022 XRP's price has declined to around $2.40-2.65, down approximately 20% over the past month from expectations of surpassing $4, with technical analysts providing mixed signals\u2014some predicting a further drop to $2.00-2.20 while others anticipate a potential rally based on ETF catalysts and historical patterns.\n\n\u2022 XRP demonstrates significant utility potential as a cross-border payment solution, with capacity estimates suggesting it could facilitate $3-8 billion daily in cross-currency settlements. The introduction of XRP futures on CME (launched May 2024) provides regulated hedging tools for treasuries to manage inventory risk more effectively.\n\n\u2022 The XRP ecosystem continues to expand with developments like XRP Flare Account reaching $3.75M in Total Value Locked (TVL), offering users 4% APY through self-custody systems, while wrapped versions like FXRP enable XRP holders to participate in DeFi activities and earn yield on previously dormant assets.\n", "rank": 4, "classes": [ "Token Listing", "Feature Release", "Price Analysis", "Project Strategy" ], "topDocuments": [ { "url": "https://cryptopotato.com/expert-spot-ripple-xrp-etfs-could-debut-within-2-weeks/", "type": "news" }, { "url": "https://www.dlnews.com/articles/markets/xrp-etf-launches-seen-to-trigger-billion-dollar-bonanza/", "type": "news" }, { "url": "https://watcher.guru/news/xrp-down-20-in-a-month-is-the-bull-run-over", "type": "news" }, { "url": "https://cryptopotato.com/xrp-at-a-crossroads-drop-to-2-next-or-breakout-brewing/", "type": "news" }, { "url": "https://cryptoslate.com/how-xrp-can-provide-5-billion-daily-working-capital-for-currency-exchanges/", "type": "news" } ], "documentCount": 128, "avgDocumentTimestamp": "2025-11-03T11:19:08.1796875Z", "assets": [ { "id": "97775be0-2608-4720-b7af-f85b24c7eb2d", "name": "XRP", "symbol": "XRP", "slug": "xrp" } ] }, { "title": "Evolution of Airdrop Strategies and User Participation", "summary": "Cryptocurrency airdrops are evolving from simple token giveaways to strategic user onboarding mechanisms with increasingly sophisticated eligibility criteria. Projects like MMT Finance, idOS Network, and PlayAI Network are implementing verification requirements, activity thresholds, and time-sensitive registration windows, while users navigate a changing landscape where genuine ecosystem participation is becoming more valuable than passive collection.\n", "content": "\u2022 Cryptocurrency airdrops are evolving from simple giveaways to strategic onboarding mechanisms, with projects like MMT Finance requiring both wallet and social media verification to \"filter signal from noise\" and have users prove their presence rather than merely claim tokens.\n\n\u2022 Several time-sensitive airdrop opportunities are currently active, including MMT Finance's Wave 1 subscription (with hours remaining), idOS Network's confirmed airdrop (with potential rewards of $4-5K), PlayAI Network's $PLAI registration closing with TGE on November 4, and XP token on TON blockchain listing in 3 days.\n\n\u2022 Airdrop eligibility criteria are becoming more sophisticated, targeting genuine ecosystem participants through requirements like trading volume thresholds, liquidity provision, platform usage, NFT ownership, and active community engagement, with some projects implementing \"Play-to-Airdrop\" campaigns.\n\n\u2022 Many users are expressing mixed sentiments about airdrops, with some sharing their \"October airdrop wins\" (often sarcastically showing $0 across multiple projects), while others discuss strategic positioning for upcoming drops like Limitless, IdOS, Mira, Infinit, and Base.\n\n\u2022 The \"free airdrop meta\" appears to be shifting, with future token distributions likely to depend more heavily on users' on-chain footprint and willingness to pay for participation, as suggested by developments from major players like MetaMask and OpenSea.\n", "rank": 5, "classes": [ "Airdrop", "Macro Commentary" ], "topDocuments": [ { "url": "https://x.com/nonceXBT/status/1985338445544182091", "type": "x_post" }, { "url": "https://x.com/astropol0/status/1985072047173914732", "type": "x_post" }, { "url": "https://x.com/aibra/status/1985103891810390243", "type": "x_post" }, { "url": "https://x.com/erequendiweb3/status/1985312249784000769", "type": "x_post" }, { "url": "https://x.com/juan3121z/status/1985370319461491016", "type": "x_post" } ], "documentCount": 396, "avgDocumentTimestamp": "2025-11-03T10:48:48.217171717Z", "assets": [ { "id": "122766c0-fbf4-4275-bef8-291da55220e9", "name": "Monad", "symbol": "MON", "slug": "monad" } ] } ], "metadata": { "pageSize": 1000, "page": 0, "totalRows": 124, "totalPages": 1, "includedClasses": [ "Treasury Management", "Treasury Expense", "Project Team Funding", "Incentives Program", "Discontinued Product" ] } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "403": { "$ref": "#/components/responses/Forbidden" }, "500": { "$ref": "#/components/responses/InternalServerError" } } } }, "/topics/v1/daily": { "get": { "description": "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.", "operationId": "getGlobalTopicsTimeseriesV1", "tags": [ "Topics" ], "summary": "Get Global Topics Timeseries", "parameters": [ { "name": "start", "in": "query", "required": true, "description": "Start of time range in ISO 8601 format", "schema": { "type": "string", "format": "date-time", "default": "2025-10-01T00:00:00Z", "example": "2025-10-01T00:00:00Z" } }, { "name": "end", "in": "query", "required": true, "description": "End of time range in ISO 8601 format", "schema": { "type": "string", "format": "date-time", "default": "2025-10-03T23:59:59Z", "example": "2025-10-03T23:59:59Z" } }, { "name": "granularity", "in": "query", "description": "Time granularity for data points", "schema": { "type": "string", "enum": [ "1d", "1h" ], "default": "1d" } }, { "name": "assetIDs", "in": "query", "description": "Comma-separated list of asset identifiers to filter topics by associated assets. Accepts UUIDs, slugs, or symbols.", "schema": { "type": "string", "example": "bitcoin,ETH,21c795f5-1bfd-40c3-858e-e9d7e820c6d0" } } ], "responses": { "200": { "description": "Successfully retrieved topics timeseries", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TopicsTimeseriesResponse" }, "example": { "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" } ] } ] } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "403": { "$ref": "#/components/responses/Forbidden" }, "500": { "$ref": "#/components/responses/InternalServerError" } } } } }, "components": { "securitySchemes": { "ApiKeyAuth": { "type": "apiKey", "in": "header", "name": "x-messari-api-key", "description": "API key for authentication. Get your key at https://messari.io/account/api" } }, "schemas": { "TopicsResponse": { "type": "object", "properties": { "error": { "type": "string", "nullable": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Topic" } }, "metadata": { "$ref": "#/components/schemas/TopicsMetadata" } } }, "TopicsTimeseriesResponse": { "type": "object", "properties": { "error": { "type": "string", "nullable": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/TopicPoint" } } } }, "Topic": { "type": "object", "properties": { "title": { "type": "string", "description": "Title of the topic" }, "summary": { "type": "string", "description": "Brief summary of the topic" }, "content": { "type": "string", "description": "Detailed content about the topic" }, "rank": { "type": "number", "description": "Ranking of the topic" }, "classes": { "type": "array", "items": { "type": "string" }, "description": "Topic classification tags" }, "topDocuments": { "type": "array", "items": { "$ref": "#/components/schemas/TopicDocument" }, "description": "Top source documents for this topic" }, "documentCount": { "type": "number", "description": "Number of source documents" }, "avgDocumentTimestamp": { "type": "string", "format": "date-time", "description": "Average timestamp of source documents" }, "assets": { "type": "array", "items": { "$ref": "#/components/schemas/AssetEntity" }, "description": "Assets associated with this topic" } } }, "TopicPoint": { "type": "object", "properties": { "time": { "type": "integer", "description": "Unix timestamp" }, "title": { "type": "string", "description": "Title of the topic" }, "summary": { "type": "string", "description": "Brief summary of the topic" }, "content": { "type": "string", "description": "Detailed content about the topic" }, "classes": { "type": "array", "items": { "type": "string" }, "description": "Topic classification tags" }, "topDocuments": { "type": "array", "items": { "$ref": "#/components/schemas/TopicDocument" }, "description": "Top source documents" }, "rank": { "type": "integer", "description": "Ranking of the topic at this timestamp" }, "documentCount": { "type": "number", "description": "Number of source documents" }, "assets": { "type": "array", "items": { "$ref": "#/components/schemas/AssetEntity" }, "description": "Assets associated with this topic" } } }, "TopicDocument": { "type": "object", "properties": { "url": { "type": "string", "description": "URL of the source document" }, "type": { "type": "string", "description": "Type of document (e.g., x_post, article)" } } }, "AssetEntity": { "type": "object", "properties": { "id": { "type": "string", "description": "Asset UUID" }, "name": { "type": "string", "description": "Asset name" }, "symbol": { "type": "string", "description": "Asset symbol" }, "slug": { "type": "string", "description": "Asset slug" } } }, "TopicsMetadata": { "type": "object", "properties": { "snapshotTime": { "type": "string", "format": "date-time", "description": "Timestamp of the data snapshot" }, "includedClasses": { "type": "array", "items": { "type": "string" }, "description": "List of topic classes included in the results" } } } }, "responses": { "BadRequest": { "description": "Bad request - invalid parameters", "content": { "application/json": { "schema": { "properties": { "error": { "type": "string" } }, "type": "object" } } } }, "Forbidden": { "description": "Forbidden - insufficient subscription tier", "content": { "application/json": { "schema": { "properties": { "error": { "type": "string" } }, "type": "object" } } } }, "InternalServerError": { "description": "Internal server error", "content": { "application/json": { "schema": { "properties": { "error": { "type": "string" } }, "type": "object" } } } } } } }