# Risk Factor Categories Taxonomy

> Risk Factor Categories Taxonomy is a paid API for AI agents from agent.massive.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Returns the complete list of risk factor classifications (primary, secondary, tertiary categories) used to categorize stock risk factors in SEC filings.

## Facts

- Endpoint: GET https://agent.massive.com/stocks/taxonomies/vX/risk-factors
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/risk-factor-categories-taxonomy-4f0f974d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hgQbaZY9rNwrobmVPdIkD

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability risk-factor-categories-taxonomy-4f0f974d
```

Example prompt: Can you pull the full list of risk factor categories and classifications used in Massive's stock risk factors endpoint, including all primary and secondary categories, sorted alphabetically?

## When to prefer this

Use this endpoint when you need to discover valid risk factor classification values before filtering or querying the main risk factors endpoint, when building filter UIs for stock risk analysis tools, or when you need to understand the hierarchical structure of risk categories across taxonomy versions. Prefer this over guessing category strings to avoid zero-result queries.

## Known failure modes

- Invalid taxonomy version number returns empty results or 400 error
- Misspelled category filter strings return no matches
- Limit exceeding 1000 results in a validation error
- Requesting a non-existent taxonomy version returns empty result set
- Rate limiting or payment failure with x402 protocol returns 402 Payment Required

## How this service works

The complete list of risk factor classifications used in the risk factors endpoint. Can't find what you're looking for? POST feedback to /feedback, no charge.

## Output

A paginated list of risk factor taxonomy entries, each containing a taxonomy version number, primary category (top-level risk type), secondary category (mid-level classification), and tertiary category (most specific classification). Results are sortable and filterable by any category level or taxonomy version, with up to 1000 entries per call.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "sort": {
       "type": "string",
       "default": "taxonomy.desc",
       "description": "A comma separated list of sort columns. For each column, append '.asc' or '.desc' to specify the sort direction. The sort column defaults to 'taxonomy' if not specified. The sort order defaults to 'desc' if not specified."
      },
      "limit": {
       "type": "integer",
       "default": 200,
       "maximum": 1000,
       "minimum": 1,
       "description": "Limit the maximum number of results returned. Defaults to '200' if not specified. The maximum allowed limit is '1000'."
      },
      "taxonomy": {
       "type": "number",
       "format": "double",
       "description": "Version identifier (e.g., '1.0', '1.1') for the taxonomy Value must be a floating point number."
      },
      "taxonomy.gt": {
       "type": "number",
       "format": "double",
       "description": "Filter greater than the value. Value must be a floating point number."
      },
      "taxonomy.lt": {
       "type": "number",
       "format": "double",
       "description": "Filter less than the value. Value must be a floating point number."
      },
      "taxonomy.gte": {
       "type": "number",
       "format": "double",
       "description": "Filter greater than or equal to the value. Value must be a floating point number."
      },
      "taxonomy.lte": {
       "type": "number",
       "format": "double",
       "description": "Filter less than or equal to the value. Value must be a floating point number."
      },
      "primary_category": {
       "type": "string",
       "description": "Top-level risk category"
      },
      "tertiary_category": {
       "type": "string",
       "description": "Most specific risk classification"
      },
      "secondary_category": {
       "type": "string",
       "description": "Mid-level risk category"
      },
      "primary_category.gt": {
       "type": "string",
       "description": "Filter greater than the value."
      },
      "primary_category.lt": {
       "type": "string",
       "descript
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "status": "OK",
  "results": [
   {
    "taxonomy": "1.0",
    "description": "Risk from inadequate performance management systems, unclear accountability structures, or ineffective measurement and incentive systems that could affect employee performance, goal achievement, and organizational effectiveness.",
    "primary_category": "Governance & Stakeholder",
    "tertiary_category": "Performance management and accountability",
    "secondary_category": "Organizational & Management"
   },
   {
    "taxonomy": "1.0",
    "description": "Risk from requirements to monitor, document, and report on compliance with privacy and data protection regulations including risks from compliance program effectiveness, record-keeping requirements, and breach notification obligations.",
    "primary_category": "Regulatory & Compliance",
    "tertiary_category": "Compliance monitoring and reporting",
    "secondary_category": "Data & Privacy"
   }
  ],
  "request_id": "daac836f71724420b66011d55d88b30b"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/risk-factor-categories-taxonomy-4f0f974d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent.massive.com](https://www.zero.xyz/host/agent.massive.com/llms.txt)