# x402stock Stock Score Factors

> x402stock Stock Score Factors is a paid API for AI agents from x402stock.xyz, paid per call via x402, $0.15/call, status unknown (last checked 2026-09-14).

Returns a multi-factor composite score (value, quality, growth, momentum) for a US stock ticker, with per-factor metrics and labels.

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/score/factors/%7Bticker%7D
- Price: $0.15/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-stock-score-factors-91636140
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Mr9gB530DmJ_TPwobAID3

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 x402stock-stock-score-factors-91636140
```

Example prompt: Can you pull the multi-factor stock score for AAPL — I want to see how it rates on value, quality, growth, and momentum, along with the composite score?

## When to prefer this

Use this endpoint when you need a structured, quantitative multi-factor score for a US stock and want value, quality, growth, and momentum broken down with underlying metrics. Prefer this over raw price feeds when the goal is fundamental evaluation or screening. Good for comparing how a stock fares across multiple investment factor lenses without needing to compute ratios yourself.

## Known failure modes

- Invalid or unknown ticker returns an error or empty response
- Ticker exists but insufficient data for one or more factors reduces confidence
- Payment not completed (x402 flow not honored) returns 402 Payment Required
- Rate limiting or upstream data unavailability returns 5xx
- Options or non-US tickers may not be supported

## How this service works

Pay-per-call market and economic data API for AI agents: US stocks, ETFs and options, forex, crypto and on-chain perps, energy commodities, US and global macro (Fed, CPI, jobs, GDP, Treasury, World Bank), SEC filings, congressional trades, and market sentiment. No API keys, no accounts. Pay per request in USDC via x402 on Base.

## Output

A JSON object containing: a composite score (0–100) with label and confidence; four factor sub-scores (value, quality, growth, momentum) each with a numeric score, label (e.g. 'strong', 'average'), and underlying metrics (P/E, P/S, P/B, ROE, margins, debt/equity, revenue/earnings growth, trailing return); fiscal inputs used; data freshness timestamp; and a methodology disclaimer.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "as_of": "2026-06-08T12:00:00.000Z",
  "inputs": {
   "price": 205.4,
   "equity": 62000000000,
   "revenue": 391000000000,
   "market_cap": 3100000000000,
   "net_income": 97000000000,
   "fiscal_year": "2025"
  },
  "source": "x402stock",
  "ticker": "AAPL",
  "factors": {
   "value": {
    "label": "average",
    "score": 42,
    "metrics": {
     "pb": 49.8,
     "pe": 31.2,
     "ps": 8.1
    }
   },
   "growth": {
    "label": "average",
    "score": 58,
    "metrics": {
     "revenue_growth_yoy": 0.06,
     "earnings_growth_yoy": 0.1
    }
   },
   "quality": {
    "label": "strong",
    "score": 92,
    "metrics": {
     "roe": 1.56,
     "net_margin": 0.25,
     "gross_margin": 0.46,
     "debt_to_equity": 1.51
    }
   },
   "momentum": {
    "label": "strong",
    "score": 75,
    "metrics": {
     "above_mean": true,
     "trailing_return": 0.21
    }
   }
  },
  "sections": {
   "price": "ok",
   "profile": "ok",
   "financials": "ok",
   "price_history": "ok"
  },
  "composite": {
   "max": 100,
   "label": "above_average",
   "value": 64.5,
   "confidence": 1
  },
  "disclaimer": "Factual quantitative analysis, not investment advice. Inputs are delayed/periodic; verify before acting.",
  "methodology": "Four equally-weighted factors, each 0–100 from absolute thresholds (not cross-sectional percentiles): Value (P/E, P/S, P/B — lower is better), Quality (ROE, gross & net margin, debt/equity), Growth (YoY revenue & earnings), Momentum (trailing price return). Composite = mean of available factors."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-stock-score-factors-91636140/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402stock.xyz](https://www.zero.xyz/host/x402stock.xyz/llms.txt)