{"uid":"cap_NJV28wwUjFY5dR2MOZiAT","slug":"zeroclick-x402-service-registry-stock-price-finnhub-3fb4dd48","name":"Stock Price (Finnhub)","description":"Stock quotes via Finnhub and historical timeseries via Twelve Data. Input: `action` (quote/timeseries), `symbol` (e.g. AAPL, MSFT, TSLA), optional `exchange` (e.g. NASDAQ, NYSE). For timeseries: `interval` (1min/5min/15min/30min/45min/1h/2h/4h/1day/1week/1month, default 1day), `outputsize` (1-5000 data points, default 30), `start_date` and `end_date` (YYYY-MM-DD or YYYY-MM-DD HH:MM:SS). quote returns: symbol, name, price, open, high, low, close, volume, change, percent_change, is_market_open, exchange, currency. timeseries returns: symbol, interval, currency, values array of {datetime, open, high, low, close, volume}. Covers stocks, ETFs, forex, crypto, and indices. Use uppercase ticker symbols.","url":"https://stocks.withzero.ai/run?utm_source=zero.xyz","method":"POST","headers":{"X-ZAM-Access-Key":"zeroclick"},"bodySchema":{"type":"object","required":["symbol"],"properties":{"action":{"enum":["quote","timeseries"],"type":"string","default":"quote","description":"quote: real-time price; timeseries: historical OHLCV data"},"symbol":{"type":"string","maxLength":20,"minLength":1,"description":"Stock ticker symbol (e.g. AAPL, MSFT, BTC/USD)"},"end_date":{"type":"string","description":"End date for timeseries (YYYY-MM-DD or YYYY-MM-DD HH:MM:SS)"},"exchange":{"type":"string","description":"Exchange name to disambiguate (e.g. NASDAQ, NYSE)"},"interval":{"enum":["1min","5min","15min","30min","45min","1h","2h","4h","1day","1week","1month"],"type":"string","default":"1day","description":"Timeseries interval (default 1day)"},"outputsize":{"type":"integer","default":30,"maximum":5000,"minimum":1,"description":"Number of data points to return for timeseries (default 30)"},"start_date":{"type":"string","description":"Start date for timeseries (YYYY-MM-DD or YYYY-MM-DD HH:MM:SS)"}},"additionalProperties":false},"responseSchema":{"type":"object","required":["action","symbol"],"properties":{"low":{"type":"number","description":"Day low"},"high":{"type":"number","description":"Day high"},"name":{"type":"string","description":"Company name"},"open":{"type":"number","description":"Open price"},"close":{"type":"number","description":"Previous close"},"price":{"type":"number","description":"Current price"},"action":{"type":"string","description":"Action performed"},"change":{"type":"number","description":"Price change"},"symbol":{"type":"string","description":"Stock symbol"},"values":{"type":"array","items":{"type":"object","required":["datetime","open","high","low","close"],"properties":{"low":{"type":"number","description":"Low price"},"high":{"type":"number","description":"High price"},"open":{"type":"number","description":"Open price"},"close":{"type":"number","description":"Close price"},"volume":{"type":"number","description":"Volume"},"datetime":{"type":"string","description":"Datetime of the bar"}},"additionalProperties":false},"description":"OHLCV timeseries data (most recent first)"},"volume":{"type":"number","description":"Volume"},"currency":{"type":"string","description":"Currency code"},"exchange":{"type":"string","description":"Exchange name"},"interval":{"type":"string","description":"Timeseries interval"},"is_market_open":{"type":"boolean","description":"Whether market is currently open"},"percent_change":{"type":"number","description":"Percent price change"}},"additionalProperties":false},"example":{"request":{"action":"quote","symbol":"AAPL"},"response":{"low":301.17,"high":317.4,"name":"Apple Inc","open":308.739,"close":307.34,"price":301.54,"action":"quote","change":-5.8,"symbol":"AAPL","currency":"USD","exchange":"NASDAQ NMS - GLOBAL MARKET","is_market_open":false,"percent_change":-1.8872}},"exampleRequest":{"action":"quote","symbol":"AAPL"},"tags":["finance","stock","stocks","price","finnhub","market","timeseries","quote","equities"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":1,"rating":{"score":"0.92","successRate":"0.61","reviews":1,"stars":"4.7","state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_p31DB2obApWONQMjwET0r","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":"stock-price-finnhub:1"}],"brandName":"ZeroClick x402 Service Registry","brandSlug":"zeroclick-x402-service-registry","brandBaseUrl":"https://withzero.ai","brandDocsUrl":null,"whatItDoes":"Fetches real-time stock quotes and historical OHLCV timeseries data for stocks, ETFs, forex, crypto, and indices via Finnhub","exampleAgentPrompt":"What's the current price of AAPL on NASDAQ right now — is the market open, and how much has it changed today in percent?","exampleUseCases":null,"resultDescription":"For a quote action: returns symbol, company name, current price, open, high, low, previous close, volume, price change, percent change, market open status, exchange, and currency. For a timeseries action: returns symbol, interval, currency, and an array of OHLCV bars each containing datetime, open, high, low, close, and volume, ordered most recent first.","failureModes":["Unknown or invalid ticker symbol returns an error or empty response","Unsupported exchange or ambiguous symbol without exchange disambiguation may return wrong instrument","Date range outside available history may return empty values array","Malformed date format (not YYYY-MM-DD) causes a request error","outputsize exceeding 5000 or below 1 is rejected by schema validation","Crypto pair format (e.g. BTC/USD) may behave differently from equity tickers"],"whenToPreferThis":"Use this endpoint when you need real-time stock quotes or historical OHLCV candlestick data for equities, ETFs, crypto, forex, or indices via Finnhub. Prefer it over the Crypto Prices (Binance) endpoint when you want stock or forex data, or when you need OHLCV timeseries rather than just a spot price. Well-suited for portfolio tracking, charting, technical analysis inputs, or answering ad-hoc 'what's the stock price of X' questions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":18,"lastUsedAt":"2026-07-15T00:17:15.769Z","lastSuccessfullyRanAt":"2026-07-15T00:17:15.769Z","lastHealthCheckAt":"2026-10-10T00:38:19.901Z","isFirstParty":true,"canonicalSlug":"zeroclick-x402-service-registry-stock-price-finnhub-3fb4dd48"}