{"uid":"cap_VHJsx8Dd-zSi0Jj_KayuJ","slug":"agents-x402stock-xyz-x402stock-quant-factor-score-for-us-stocks-f405e569","name":"x402stock Quant Factor Score for US Stocks","description":"Returns value, quality, growth, and momentum sub-scores plus a composite score.","url":"https://agents.x402stock.xyz/api/v1/score/factors/{ticker}?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["ticker"],"properties":{"ticker":{"type":"string","description":"US-listed ticker symbol (uppercase), e.g. AAPL."}}},"responseSchema":{"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","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"boolean"}]},{"type":"null"}]}}},"additionalProperties":false},"momentum":{"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}},"additionalProperties":false},"sections":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"composite":{"type":"object","required":["value","max","label","confidence"],"properties":{"max":{"type":"number"},"label":{"type":"string"},"value":{"anyOf":[{"type":"number"},{"type":"null"}]},"confidence":{"type":"number"}},"additionalProperties":false},"disclaimer":{"type":"string"},"methodology":{"type":"string"}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.15","displayCostAsset":"USD","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.15/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.15","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.15","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_vPJ76NMDL07pkmuBYXDyy","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.15","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.x402stock.xyz","brandSlug":"agents-x402stock-xyz-x402","brandBaseUrl":"https://agents.x402stock.xyz","brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Stock screener pre-filter for value investing","prompt":"Pull the quant factor scores for AAPL so I can see how it scores on Value — especially the P/E, P/S, and P/B — compared to its Quality and Growth, and give me the composite too."},{"title":"Momentum and growth check before earnings","prompt":"Before TSLA reports earnings, can you run the factor score on it and tell me what its Growth and Momentum scores look like right now, along with the specific metrics behind those scores?"},{"title":"Portfolio quality sanity check","prompt":"I'm holding JPM and want to know if it's a high-quality stock by the numbers — can you get me the Quality factor score with the ROE, margins, and leverage metrics, plus the overall composite score?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T00:40:45.584Z","isFirstParty":false,"canonicalSlug":"agents-x402stock-xyz-x402stock-quant-factor-score-for-us-stocks-f405e569"}