# x402stock Quant Factor Score for US Stocks

> x402stock Quant Factor Score for US Stocks is a paid API for AI agents from agents.x402stock.xyz, paid per call via MPP, $0.15/call, status unknown (last checked 2026-10-05).

Returns a transparent, filing-grade quant factor score (Value, Quality, Growth, Momentum) for any US-listed stock, each 0–100, plus an equal-weighted composite, with every underlying metric included.

## Facts

- Endpoint: GET https://agents.x402stock.xyz/api/v1/score/factors/{ticker}?utm_source=zero.xyz
- Price: $0.15/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-05
- Activations on Zero: 0
- Provider: agents.x402stock.xyz
- Website: https://agents.x402stock.xyz
- Canonical page: https://www.zero.xyz/c/agents-x402stock-xyz-x402stock-quant-factor-score-for-us-stocks-f405e569
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VHJsx8Dd-zSi0Jj_KayuJ

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 agents-x402stock-xyz-x402stock-quant-factor-score-for-us-stocks-f405e569
```

Example prompt: Give me the full quant factor score breakdown for NVDA — I want to see the Value, Quality, Growth, and Momentum scores plus the composite, with all the underlying metrics like P/E, ROE, and trailing return.

## When to prefer this

Choose this endpoint when you need a transparent, metric-by-metric quant factor breakdown for a US stock grounded in SEC filing data, not just a single aggregate rating. Prefer it over generic stock screeners when the agent or user needs to see the exact inputs (P/E, ROE, revenue growth, etc.) that drove each factor score. Ideal for research agents that need to explain their reasoning, portfolio screening workflows, or pre-trade due diligence where audit-ability of the score matters.

## Known failure modes

- Invalid or unrecognized ticker returns an error — ticker must be a valid uppercase US-listed symbol
- Insufficient fundamental data for a ticker (e.g. pre-revenue company) may return null scores for some factors
- Payment failure via x402/USDC results in a 402 response and no data
- Stale or missing SEC filings for a ticker may cause factor scores to be partially null
- Non-US-listed tickers are not supported and will return an error

## How this service works

Returns value, quality, growth, and momentum sub-scores plus a composite score.

## Output

A structured JSON object containing: ticker, source, as_of date, a composite equal-weighted score, four factor objects (value, quality, growth, momentum) each with a 0–100 score, a human-readable label, and a metrics sub-object listing every raw metric used (e.g. P/E, P/S, P/B, ROE, gross margin, debt-to-equity, YoY revenue growth, YoY earnings growth, trailing return), plus methodology notes, raw inputs, and a factual disclaimer.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "ticker"
 ],
 "properties": {
  "ticker": {
   "type": "string",
   "description": "US-listed ticker symbol (uppercase), e.g. AAPL."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "ticker",
  "source",
  "as_of",
  "sections",
  "composite",
  "factors",
  "methodology",
  "inputs",
  "disclaimer"
 ],
 "properties": {
  "as_of": {
   "type": "string"
  },
  "inputs": {
   "type": "object",
   "propertyNames": {
    "type": "string"
   },
   "additionalProperties": {}
  },
  "source": {
   "type": "string",
   "const": "x402stock"
  },
  "ticker": {
   "type": "string"
  },
  "factors": {
   "type": "object",
   "required": [
    "value",
    "quality",
    "growth",
    "momentum"
   ],
   "properties": {
    "value": {
     "type": "object",
     "required": [
      "score",
      "label",
      "metrics"
     ],
     "properties": {
      "label": {
       "type": "string"
      },
      "score": {
       "anyOf": [
        {
         "type": "number"
        },
        {
         "type": "null"
        }
       ]
      },
      "metrics": {
       "type": "object",
       "propertyNames": {
        "type": "string"
       },
       "additionalProperties": {
        "anyOf": [
         {
          "anyOf": [
           {
            "type": "number"
           },
           {
            "type": "boolean"
           }
          ]
         },
         {
          "type": "null"
         }
        ]
       }
      }
     },
     "additionalProperties": false
    },
    "growth": {
     "type": "object",
     "required": [
      "score",
      "label",
      "metrics"
     ],
     "properties": {
      "label": {
       "type": "string"
      },
      "score": {
       "anyOf": [
        {
         "type": "number"
        },
        {
         "type": "null"
        }
       ]
      },
      "metrics": {
       "type": "object",
       "propertyNames": {
        "type": "string"
       },
       "additionalProperties": {
        "anyOf": [
         {
          "anyOf": [
           {
            "type": "number"
           },
           {
            "type": "boolean"
           }
          ]
         },
         {
          "type": "null"
         }
        ]
       }
      }
     },
     "additionalProperties": false
    },
    "quality": {
     "type": "object",
     "required": [
      "score",
      "label",
      "metrics"
     ],
     "properties": {
      "label": {
       "type": "string"
      },
      "score": {
       "anyOf": [
        {
         "type": "number"
        },
        {
         "type": "null"
        }
       ]
      },
      "metrics": {
       "type": "object",
    
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-x402stock-xyz-x402stock-quant-factor-score-for-us-stocks-f405e569/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.x402stock.xyz](https://www.zero.xyz/host/agents.x402stock.xyz/llms.txt)