Skip to main content
GET
/
monitoring
/
v2
/
categories
List categories
curl --request GET \
  --url https://api.messari.io/monitoring/v2/categories \
  --header 'X-Messari-API-Key: <api-key>'
{
  "error": null,
  "data": [
    {
      "slug": "component_management",
      "name": "Component Management",
      "description": "Covers changes to individual protocol components including onboarding new assets/markets, adjusting parameters, and upgrading specific components",
      "subcategories": [
        {
          "slug": "component_adjustment",
          "name": "Component Adjustment",
          "description": "Parameter changes or offboardings for specific markets/assets (not protocol-wide)"
        },
        {
          "slug": "onboarding_or_expansion",
          "name": "Onboarding or Expansion",
          "description": "Existing infrastructure expanded for new asset, market, or network (collateral listings, trading pairs, vault strategies)"
        },
        {
          "slug": "component_upgrade",
          "name": "Component Upgrade",
          "description": "Improvements to specific protocol components (single market oracle, vault logic)"
        }
      ]
    },
    {
      "slug": "launches_and_releases",
      "name": "Launches and Releases",
      "description": "Covers the release of new products, features, tokens, developer tools, and software updates",
      "subcategories": [
        {
          "slug": "mainnet_launch",
          "name": "Mainnet Launch",
          "description": "New blockchain goes live (L1, L2, rollup, appchain); includes pre-launch announcements with substantive technical detail (Pending status)"
        },
        {
          "slug": "new_product_or_feature",
          "name": "New Product or Feature",
          "description": "Entirely new functionality deployed"
        },
        {
          "slug": "testnet_launch",
          "name": "Testnet Launch",
          "description": "New test network released"
        },
        {
          "slug": "new_token",
          "name": "New Token",
          "description": "Launch of entirely new token (TGE, new governance/utility token, spinout)"
        },
        {
          "slug": "developer_tooling",
          "name": "Developer Tooling",
          "description": "Developer tools released by core team (SDKs, APIs, CLIs)"
        },
        {
          "slug": "software_release",
          "name": "Software Release",
          "description": "Updated code or client software from core team"
        },
        {
          "slug": "third_party_tooling",
          "name": "Third-Party Tooling",
          "description": "End-user tools released by external parties (wallets, dashboards)"
        }
      ]
    },
    {
      "slug": "legal_and_regulatory",
      "name": "Legal and Regulatory",
      "description": "Covers regulatory actions, enforcement, legislation, and legal proceedings affecting crypto",
      "subcategories": [
        {
          "slug": "approvals_licenses_and_registrations",
          "name": "Approvals, Licenses, and Registrations",
          "description": "Authorizations granted to operate: MTLs, VASP registrations, trust charters"
        },
        {
          "slug": "enforcement_actions",
          "name": "Enforcement Actions",
          "description": "Formal measures: lawsuits, fines, settlements, cease-and-desist"
        },
        {
          "slug": "investigations_and_inquiries",
          "name": "Investigations and Inquiries",
          "description": "Preliminary proceedings: subpoenas, Wells Notices, probes"
        },
        {
          "slug": "financial_instruments",
          "name": "Financial Instruments",
          "description": "ETFs, ETPs, trusts: creation, filing, amendment, approval, denial"
        },
        {
          "slug": "statutes_and_executive_actions",
          "name": "Statutes and Executive Actions",
          "description": "Laws, amendments, executive orders, pardons, binding government decisions"
        },
        {
          "slug": "agency_rulemaking_guidance_or_policy",
          "name": "Agency Rulemaking, Guidance, or Policy",
          "description": "Non-legislative agency actions: rulemakings, guidance, policy statements, no-action letters"
        }
      ]
    },
    {
      "slug": "performance",
      "name": "Performance",
      "description": "Covers bugs, service disruptions, blockchain halts, node outages, and chain splits",
      "subcategories": [
        {
          "slug": "bug_disclosure",
          "name": "Bug Disclosure",
          "description": "Non-security bug disclosed (affects performance, not funds)"
        },
        {
          "slug": "service_disruption",
          "name": "Service Disruption",
          "description": "Degraded performance, network still functioning"
        },
        {
          "slug": "blockchain_halt",
          "name": "Blockchain Halt",
          "description": "Network stops producing blocks, may need intervention"
        },
        {
          "slug": "node_outage",
          "name": "Node Outage",
          "description": "Specific nodes offline, may affect RPC/performance"
        },
        {
          "slug": "protocol_or_smart_contract_halt",
          "name": "Protocol or Smart Contract Halt",
          "description": "Protocol contracts paused, chain still running"
        },
        {
          "slug": "chain_split",
          "name": "Chain Split",
          "description": "Blockchain diverges into separate chains"
        }
      ]
    },
    {
      "slug": "protocol_management",
      "name": "Protocol Management",
      "description": "Covers network upgrades, governance, parameter changes, strategy, fees, migrations, discontinuations, integrations, and protocol upgrades",
      "subcategories": [
        {
          "slug": "network_upgrade",
          "name": "Network Upgrade",
          "description": "Coordinated blockchain upgrade requiring node operator participation"
        },
        {
          "slug": "governance_update",
          "name": "Governance Update",
          "description": "Changes to governance contracts, structure, or processes"
        },
        {
          "slug": "protocol_parameter_change",
          "name": "Protocol Parameter Change",
          "description": "Global/protocol-wide parameter changes (not asset-specific)"
        },
        {
          "slug": "project_strategy",
          "name": "Project Strategy",
          "description": "Strategy or roadmap changes"
        },
        {
          "slug": "protocol_fee_adjustment",
          "name": "Protocol Fee Adjustment",
          "description": "Changes to fees charged or distributed"
        },
        {
          "slug": "migration_or_swap",
          "name": "Migration or Swap",
          "description": "Token contract migration or swap to different token"
        },
        {
          "slug": "discontinuation",
          "name": "Discontinuation",
          "description": "Permanent ending of product, service, or feature"
        },
        {
          "slug": "integration_or_partnership",
          "name": "Integration or Partnership",
          "description": "Formal partnership or integration of external infrastructure"
        },
        {
          "slug": "protocol_upgrade",
          "name": "Protocol Upgrade",
          "description": "Major upgrade or new version of protocol smart contracts"
        }
      ]
    },
    {
      "slug": "security_and_hacks",
      "name": "Security and Hacks",
      "description": "Covers exploits, hacks, vulnerability disclosures, and loss of funds incidents",
      "subcategories": [
        {
          "slug": "protocol_exploit",
          "name": "Protocol Exploit",
          "description": "Attack on core smart contracts, funds lost"
        },
        {
          "slug": "frontend_exploit",
          "name": "Frontend Exploit",
          "description": "Attacks targeting project frontends (DNS hijacking, CDN compromise, client-side code); contracts intact"
        },
        {
          "slug": "vulnerability_disclosure",
          "name": "Vulnerability Disclosure",
          "description": "Disclosure of security vulnerabilities that could have enabled unauthorized access, fund theft, or protocol manipulation — not yet exploited"
        },
        {
          "slug": "custodian_loss_of_funds",
          "name": "Custodian Loss of Funds",
          "description": "Exchange or custodian loses funds"
        },
        {
          "slug": "consensus_related_exploit",
          "name": "Consensus-Related Exploit",
          "description": "51% attack or similar consensus violation"
        },
        {
          "slug": "other_hack_or_attack",
          "name": "Other Hack or Attack",
          "description": "Security incidents not fitting other categories"
        }
      ]
    },
    {
      "slug": "team_and_operations",
      "name": "Team and Operations",
      "description": "Covers branding, funding initiatives, organization changes, M&A, personnel, and official reports",
      "subcategories": [
        {
          "slug": "new_brand_or_rebrand",
          "name": "New Brand or Rebrand",
          "description": "Brand or name change"
        },
        {
          "slug": "centralized_funding_initiatives",
          "name": "Centralized Funding Initiatives",
          "description": "Team/foundation-led funding programs: grants, accelerators"
        },
        {
          "slug": "organization_change",
          "name": "Organization Change",
          "description": "Entity structure changes: foundation formation/dissolution, jurisdiction changes"
        },
        {
          "slug": "mergers_acquisitions_or_fundraising",
          "name": "Mergers, Acquisitions, or Fundraising",
          "description": "M&A and funding rounds"
        },
        {
          "slug": "personnel_change",
          "name": "Personnel Change",
          "description": "Executive, advisor, or multisig signer changes (not layoffs or restructuring — see Organization Change)"
        },
        {
          "slug": "official_report_or_update",
          "name": "Official Report or Update",
          "description": "Formal reports: attestations, financials, audits, post-mortems"
        }
      ]
    },
    {
      "slug": "token_listing",
      "name": "Token Listing",
      "description": "Covers spot listings, delistings, and other listing types on exchanges and platforms",
      "subcategories": [
        {
          "slug": "spot_listing",
          "name": "Spot Listing",
          "description": "Major centralized exchange enables spot trading for an asset"
        },
        {
          "slug": "delisting",
          "name": "Delisting",
          "description": "Exchange removes asset from trading"
        },
        {
          "slug": "other_listing",
          "name": "Other Listing",
          "description": "Non-trading integrations: custody, staking, index inclusion"
        }
      ]
    },
    {
      "slug": "tokenomics",
      "name": "Tokenomics",
      "description": "Covers airdrops, buybacks, token utility, revenue distribution, supply changes, and token allocations",
      "subcategories": [
        {
          "slug": "airdrop",
          "name": "Airdrop",
          "description": "Initial token distribution to select user groups, typically at TGE, retrospective based on historical behavior"
        },
        {
          "slug": "token_buybacks",
          "name": "Token Buybacks",
          "description": "DAO or key contributing entity repurchases the protocol's native tokens"
        },
        {
          "slug": "token_utility",
          "name": "Token Utility",
          "description": "Updates to a token's use case within its ecosystem"
        },
        {
          "slug": "revenue_distribution",
          "name": "Revenue Distribution",
          "description": "Protocol profits distributed to native token holders, stakers, or other parties; includes reward redirection"
        },
        {
          "slug": "token_supply",
          "name": "Token Supply",
          "description": "Changes to circulating or total supply not in original distribution: locks, unlocks, emissions adjustments, non-programmatic mints/burns"
        },
        {
          "slug": "other_tokenomics_update",
          "name": "Other Tokenomics Update",
          "description": "Catch-all for tokenomics changes not fitting other subcategories"
        },
        {
          "slug": "native_token_allocation",
          "name": "Native Token Allocation",
          "description": "Creation or adjustment of ongoing/scheduled native token distributions: vesting unlocks, emissions, incentive programs (seasons, points, liquidity mining)"
        }
      ]
    },
    {
      "slug": "treasury_management",
      "name": "Treasury Management",
      "description": "Covers strategic investments, treasury expenses, and other treasury operations",
      "subcategories": [
        {
          "slug": "strategic_investment",
          "name": "Strategic Investment",
          "description": "Treasury assets deployed for strategic purposes: acquisitions, token swaps, OTC deals, grants to external projects, investments"
        },
        {
          "slug": "treasury_expense",
          "name": "Treasury Expense",
          "description": "Operational costs: payroll, contractors, infrastructure, audits, legal, marketing, overhead"
        },
        {
          "slug": "other_treasury_operations",
          "name": "Other Treasury Operations",
          "description": "Treasury activities that aren't expenses or investments: diversification, rebalancing, transfers, structure changes"
        }
      ]
    },
    {
      "slug": "no_category",
      "name": "No Category",
      "description": "Fallback classification for developments that do not match any defined category",
      "subcategories": [
        {
          "slug": "no_subcategory",
          "name": "No Subcategory",
          "description": "Fallback classification for documents that do not match any defined category or subcategory"
        }
      ]
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.messari.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

X-Messari-API-Key
string
header
required

Response

Default response

data
object[]
required
error
string | null