{"uid":"cap_dVX5oZHroPD1ip1Dwq4HB","slug":"api-stocktrends-com-475302a0","name":"Stock Trends Ranked Screener","description":"Ranked Stock Trends signal screener for agent workflows, using trend state, trend persistence, trend maturity, relative performance, and volume signal fields.","url":"https://api.stocktrends.com/v1/agent/screener/top","method":"GET","headers":{},"bodySchema":{"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","required":[],"properties":{"limit":{"type":"integer","default":25,"maximum":100,"minimum":1},"min_rsi":{"type":"integer","default":40},"exchange":{"enum":["N","Q","A","B","T","I"],"type":"string"}},"additionalProperties":false}},"additionalProperties":false},"title":{"type":"string"},"family":{"type":"string"},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"json"},"format":{"type":"string"},"example":{}},"description":"Ranked instruments with Stock Trends signal fields and filter summary.","additionalProperties":true},"category":{"type":"string"},"schemaUrl":{"type":"string"},"description":{"type":"string"},"metadataUrl":{"type":"string"},"tools_manifest":{"type":"string"},"pricing_catalog":{"type":"string"}},"additionalProperties":true},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"limit":25,"min_rsi":50,"exchange":"Q"}}},"response":{"count":25,"results":[{"rsi":2130,"rank":1,"trend":"^+","mt_cnt":5,"symbol":"VIVK","vol_tag":"*","exchange":"Q","rsi_updn":"-","weekdate":"2026-06-05","trend_cnt":4,"symbol_exchange":"VIVK-Q"},{"rsi":1632,"rank":2,"trend":"v^","mt_cnt":1,"symbol":"SILO","vol_tag":"!","exchange":"Q","rsi_updn":"+","weekdate":"2026-06-05","trend_cnt":1,"symbol_exchange":"SILO-Q"},{"rsi":1269,"rank":3,"trend":"^+","mt_cnt":2,"symbol":"ASTC","vol_tag":"","exchange":"Q","rsi_updn":"-","weekdate":"2026-06-05","trend_cnt":1,"symbol_exchange":"ASTC-Q"},{"rsi":808,"rank":4,"trend":"^+","mt_cnt":8,"symbol":"MGRT","vol_tag":"!","exchange":"Q","rsi_updn":"-","weekdate":"2026-06-05","trend_cnt":8,"symbol_exchange":"MGRT-Q"},{"rsi":714,"rank":5,"trend":"^+","mt_cnt":11,"symbol":"JLHL","vol_tag":"","exchange":"Q","rsi_updn":"+","weekdate":"2026-06-05","trend_cnt":11,"symbol_exchange":"JLHL-Q"},{"rsi":479,"rank":6,"trend":"^+","mt_cnt":6,"symbol":"STAK","vol_tag":"*","exchange":"Q","rsi_updn":"+","weekdate":"2026-06-05","trend_cnt":1,"symbol_exchange":"STAK-Q"},{"rsi":474,"rank":7,"trend":"v^","mt_cnt":1,"symbol":"PIII","vol_tag":"!","exchange":"Q","rsi_updn":"-","weekdate":"2026-06-05","trend_cnt":1,"symbol_exchange":"PIII-Q"},{"rsi":470,"rank":8,"trend":"^+","mt_cnt":39,"symbol":"MXL","vol_tag":"","exchange":"Q","rsi_updn":"-","weekdate":"2026-06-05","trend_cnt":10,"symbol_exchange":"MXL-Q"},{"rsi":463,"rank":9,"trend":"^+","mt_cnt":8,"symbol":"BBGI","vol_tag":"!","exchange":"Q","rsi_updn":"+","weekdate":"2026-06-05","trend_cnt":7,"symbol_exchange":"BBGI-Q"},{"rsi":398,"rank":10,"trend":"^+","mt_cnt":8,"symbol":"BAND","vol_tag":"","exchange":"Q","rsi_updn":"+","weekdate":"2026-06-05","trend_cnt":7,"symbol_exchange":"BAND-Q"},{"rsi":331,"rank":11,"trend":"^+","mt_cnt":3,"symbol":"MKDW","vol_tag":"!","exchange":"Q","rsi_updn":"+","weekdate":"2026-06-05","trend_cnt":2,"symbol_exchange":"MKDW-Q"},{"rsi":319,"rank":12,"trend":"^+","mt_cnt":9,"symbol":"SVCO","vol_tag":"","exchange":"Q","rsi_updn":"+","weekdate":"2026-06-05","trend_cnt":8,"symbol_exchange":"SVCO-Q"},{"rsi":313,"rank":13,"trend":"v^","mt_cnt":1,"symbol":"GVH","vol_tag":"!","exchange":"Q","rsi_updn":"-","weekdate":"2026-06-05","trend_cnt":1,"symbol_exchange":"GVH-Q"},{"rsi":299,"rank":14,"trend":"^+","mt_cnt":5,"symbol":"PENG","vol_tag":"","exchange":"Q","rsi_updn":"+","weekdate":"2026-06-05","trend_cnt":4,"symbol_exchange":"PENG-Q"},{"rsi":298,"rank":15,"trend":"^+","mt_cnt":2,"symbol":"CUE","vol_tag":"!","exchange":"Q","rsi_updn":"+","weekdate":"2026-06-05","trend_cnt":1,"symbol_exchange":"CUE-Q"},{"rsi":284,"rank":16,"trend":"^+","mt_cnt":13,"symbol":"CVGI","vol_tag":"!","exchange":"Q","rsi_updn":"-","weekdate":"2026-06-05","trend_cnt":12,"symbol_exchange":"CVGI-Q"},{"rsi":279,"rank":17,"trend":"^+","mt_cnt":52,"symbol":"NVTS","vol_tag":"","exchange":"Q","rsi_updn":"-","weekdate":"2026-06-05","trend_cnt":9,"symbol_exchange":"NVTS-Q"},{"rsi":274,"rank":18,"trend":"^+","mt_cnt":7,"symbol":"ARM","vol_tag":"","exchange":"Q","rsi_updn":"-","weekdate":"2026-06-05","trend_cnt":6,"symbol_exchange":"ARM-Q"},{"rsi":270,"rank":19,"trend":"^+","mt_cnt":30,"symbol":"SNDK","vol_tag":"","exchange":"Q","rsi_updn":"-","weekdate":"2026-06-05","trend_cnt":30,"symbol_exchange":"SNDK-Q"},{"rsi":269,"rank":20,"trend":"^+","mt_cnt":33,"symbol":"MRVL","vol_tag":"*","exchange":"Q","rsi_updn":"+","weekdate":"2026-06-05","trend_cnt":15,"symbol_exchange":"MRVL-Q"},{"rsi":264,"rank":21,"trend":"^+","mt_cnt":3,"symbol":"TJGC","vol_tag":"*","exchange":"Q","rsi_updn":"+","weekdate":"2026-06-05","trend_cnt":2,"symbol_exchange":"TJGC-Q"},{"rsi":262,"rank":22,"trend":"v^","mt_cnt":1,"symbol":"LIXT","vol_tag":"*","exchange":"Q","rsi_updn":"+","weekdate":"2026-06-05","trend_cnt":1,"symbol_exchange":"LIXT-Q"},{"rsi":257,"rank":23,"trend":"^+","mt_cnt":9,"symbol":"LCUT","vol_tag":"","exchange":"Q","rsi_updn":"+","weekdate":"2026-06-05","trend_cnt":8,"symbol_exchange":"LCUT-Q"},{"rsi":255,"rank":24,"trend":"^+","mt_cnt":34,"symbol":"QTTB","vol_tag":"","exchange":"Q","rsi_updn":"+","weekdate":"2026-06-05","trend_cnt":4,"symbol_exchange":"QTTB-Q"},{"rsi":252,"rank":25,"trend":"^+","mt_cnt":46,"symbol":"AEHR","vol_tag":"","exchange":"Q","rsi_updn":"+","weekdate":"2026-06-05","trend_cnt":22,"symbol_exchange":"AEHR-Q"}],"screener":"top","weekdate":"2026-06-05","request_id":"3dead674-d3c1-4916-a531-2023a9d04bc9","total_matched":1326,"filter_summary":{"sort":"rsi","min_rsi":50,"exchange":"Q","min_mt_cnt":1,"trend_filter":["^+","^-","v^"],"min_trend_cnt":1}}},"exampleRequest":{"limit":25,"min_rsi":50,"exchange":"Q"},"tags":["x402"],"displayCostAmount":"0.5","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.5/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_GuR1bHRFuqCCIo8nancWs","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.5","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Screens and ranks stocks by Stock Trends signal fields including trend state, trend persistence, trend maturity, relative performance, and volume activity.","exampleAgentPrompt":"Show me the top 25 stocks on NASDAQ ranked by Stock Trends signals — filter for minimum RSI of 50 and give me their trend state, trend persistence, and relative performance scores.","exampleUseCases":[{"title":"Build a watchlist of emerging momentum leaders","prompt":"Find the highest-ranked stocks on NYSE with strong trend persistence and positive volume activity. I want to see the top 30 that are showing consistent uptrends and building momentum — include their trend maturity scores so I can spot which ones are early versus late stage."},{"title":"Identify stocks for portfolio rebalancing","prompt":"Screen the S&P 500 for stocks with excellent relative performance and bullish trend states. Give me the top 20 ranked by Stock Trends signals, and filter out anything with weak trend persistence so I'm only looking at stocks with sustainable upward momentum."},{"title":"Spot sector leaders across exchanges","prompt":"Show me the best-performing stocks across NASDAQ and NYSE combined, ranked by Stock Trends indicators. I'm looking for stocks with high relative performance direction, strong volume activity, and mature uptrends — just give me the top 40 so I can see which sectors are leading right now."}],"resultDescription":"A ranked list of up to 100 instruments with Stock Trends signal fields per stock (trend state, trend persistence, trend maturity, relative performance, relative performance direction, volume activity) plus a filter summary describing the applied parameters.","failureModes":["Invalid exchange code returns 400 with validation error","limit out of range (below 1 or above 100) returns 400","min_rsi out of expected bounds may return empty result set or 400","Payment not provided or insufficient USDC returns 402","Upstream data unavailable returns 503 or empty ranked list","No stocks match filter criteria returns empty results array"],"whenToPreferThis":"Use this endpoint when you need a ranked, multi-signal screener output across the full Stock Trends universe for a given exchange, particularly when trend persistence, trend maturity, and relative performance must all be considered together. Prefer this over single-symbol lookups when building watchlists, constructing portfolios, or identifying market leaders at scale.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:36:11.326Z","isFirstParty":false}