> ## 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.

# List Categories

> Full intel taxonomy — top-level categories with their nested subcategories. Static data, no filters or pagination.



## OpenAPI

````yaml GET /monitoring/v2/categories
openapi: 3.0.0
info:
  description: OpenAPI specification for the entire Messari API
  title: Messari API - Monitoring V2
  version: 1.0.0
servers:
  - description: Messari API
    url: https://api.messari.io
security: []
paths:
  /monitoring/v2/categories:
    get:
      tags:
        - monitoring/v2
      summary: List categories
      description: >-
        Full intel taxonomy — top-level categories with their nested
        subcategories. Static data, no filters or pagination.
      operationId: listMonitoringCategories
      responses:
        '200':
          description: Default response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    nullable: true
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/MonitoringCategory'
                required:
                  - data
              example:
                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
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  data:
                    nullable: true
                required:
                  - error
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  data:
                    nullable: true
                required:
                  - error
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  data:
                    nullable: true
                required:
                  - error
      security:
        - apiKey: []
components:
  schemas:
    MonitoringCategory:
      type: object
      properties:
        slug:
          type: string
        name:
          type: string
        description:
          type: string
        subcategories:
          type: array
          items:
            $ref: '#/components/schemas/MonitoringSubcategory'
      required:
        - slug
        - name
        - description
        - subcategories
    MonitoringSubcategory:
      type: object
      properties:
        slug:
          type: string
        name:
          type: string
        description:
          type: string
      required:
        - slug
        - name
        - description
  securitySchemes:
    apiKey:
      in: header
      name: X-Messari-API-Key
      type: apiKey

````