Skip to main content
GET
/
topics
/
v1
/
classes
Get Topic Classes
curl --request GET \
  --url https://api.messari.io/topics/v1/classes \
  --header 'x-messari-api-key: <api-key>'
{
  "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"
  ]
}

​
Overview

This endpoint returns all available topic classification categories. Topic classes help organize and filter topics into meaningful themes like partnerships, security events, token listings, and more.

​
Response Structure

The response includes an array of topic class names as strings. Each class represents a category that topics can be classified into.

​
Topic Class Categories

Topics are classified into the following main categories:

​
Project Development

  • Partnership: Collaborations and strategic partnerships
  • Feature Release: New feature launches and product updates
  • Network Upgrade: Protocol upgrades and improvements
  • Network Launch: New blockchain or network launches
  • Network Deployment: Deployment to new networks or chains
  • Project Announcements: General project updates and announcements
  • Project Strategy: Strategic direction and planning announcements

​
Token & Tokenomics

  • Token Listing: New exchange listings
  • Airdrop: Token airdrops and distributions
  • Token Swap or Migration: Token migrations and swaps
  • Treasury Management: Treasury operations and management
  • Treasury Expense: Treasury spending and allocations
  • Project Team Funding: Team funding rounds and allocations

​
Security & Operations

  • Security and Hacks: General security concerns
  • Protocol Exploit: Smart contract exploits and hacks
  • Vulnerability Disclosure: Security vulnerability announcements
  • Centralized Exchange Loss of Funds: Exchange-related security incidents
  • Bug Disclosure: Bug reports and disclosures
  • Network Congestion: Network performance issues
  • Blockchain Halt: Chain halts and downtime
  • Node Outage: Node and infrastructure outages
  • Chain Split: Blockchain forks and splits

​
Business & Governance

  • Funding: Fundraising rounds and investments
  • Legal and Regulatory: Regulatory news and legal developments
  • Governance Update: DAO and governance proposals
  • Incentives Program: Reward programs and incentive structures
  • Community Update: Community-driven updates and news

​
Operations & Events

  • Discontinued Product: Product sunsets and deprecations

​
Noise/Informational (typically filtered by default)

  • Macro Commentary: General market commentary
  • Price Analysis: Price predictions and technical analysis
  • Irrelevant Content: Off-topic or non-substantive content

​
Usage Example

curl -X GET "https://api.messari.io/topics/v1/classes" \
  -H "x-messari-api-key: YOUR_API_KEY"

​
Use Cases

  1. Build Filter UIs: Create topic class selectors in your application
  2. Understand Classification: Learn what categories are available for filtering
  3. Dynamic Query Building: Programmatically construct filtered topic queries
  4. Documentation: Reference available classes when using other Topics API endpoints

​
Next Steps

After retrieving the topic classes, use them to filter results in the Get Global Topics endpoint by passing them via the classes query parameter.

Authorizations

​
x-messari-api-key
string
header
required

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

Response

Successfully retrieved topic classes

​
error
string | null
​
data
string[]