Finviz stock screener

GET https://api.api.sh/finviz/v1/screener
1 credit / call finance & crypto try it in the playground →

Finviz's stock screener with every column for each match (about 115 fields: descriptive, valuation, growth, margins, ownership, short interest, performance, technicals and the latest headline). Filter with Finviz filter codes, a signal, or a ticker list, sorted by any column. 20 a page; pass next_page back as page.

Every response includes credits_used: the credits this call cost.

Parameters

nametypedescription
filters string Comma-separated Finviz filter codes (see /finviz/v1/screener-filters; codes from finviz.com URLs such as fa_pe_u20 or ta_rsi_os30 work too). Example: cap_largeover,sec_technology
order string Sort column code, '-' for descending (marketcap, price, change, volume, pe, dividendyield, perf4w ...). Example: -marketcap
signal string A Finviz signal such as ta_topgainers, ta_toplosers, ta_newhigh, ta_unusualvolume, ta_mostactive.
tickers string Only these tickers, comma-separated.
page integer Page number, starting at 1. Example: 1

Every endpoint also takes fresh, raw, fields (see lean responses and caching).

Example

curl "https://api.api.sh/finviz/v1/screener?filters=cap_largeover%2Csec_technology" \
  -H "x-api-key: $APISH_KEY"

Response

A JSON object with the fields described above, plus raw (the source's own data), cached, fetched_at and credits_used. Errors return {"success": false, "error": "…"} with the HTTP status (see errors). A lookup that ran but found nothing (404) costs the price above; refused calls and errors on our side are free (what's charged).

The fastest way to see the full response is the playground: it runs this endpoint with your account and shows the exact JSON.