{"uid":"cap__y-u8DmyttUS5US_1T2ix","slug":"apiosk-gateway-finnhub-execute-51dc3215","name":"Apiosk Gateway – Finnhub Execute","description":"Pay-per-call API gateway on the x402 protocol (HTTP 402 + USDC on Base). This document covers the gateway's discovery and execution meta-endpoints. Individual provider APIs are reachable at /{api_slug}/{path} and described by GET /{api_slug}/metadata.","url":"https://gateway.apiosk.com/finnhub/execute","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"input":{"type":"string","description":"JSON payload forwarded to the selected operation."},"operation":{"type":"string","description":"Operation id, /path, or METHOD /path selector."}}},"responseSchema":{"type":"object","required":["status","result"],"properties":{"api":{"type":"string"},"cost":{"type":"string"},"result":{"description":"Upstream response body."},"status":{"type":"string"},"latency":{"type":"number"},"operation":{"type":"string"},"upstream_status":{"type":"integer"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.138","displayCostAsset":"USDC","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.12/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.12","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.12","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_iYUCUPk9QBevL77UCjlss","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.12","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Executes a Finnhub financial data API operation via the x402 pay-per-call gateway, forwarding JSON payloads and returning the upstream response for $0.12 USDC per call.","exampleAgentPrompt":"Pull the latest stock quote and company profile for AAPL from Finnhub — use the GET /quote operation with the AAPL ticker as the JSON payload.","exampleUseCases":[{"title":"Real-time stock price lookup","prompt":"Get me the current stock price for Tesla (TSLA) from Finnhub right now — use the /quote operation."},{"title":"Company earnings calendar check","prompt":"Fetch the upcoming earnings dates for Microsoft from Finnhub using the earnings calendar operation, pass MSFT as the symbol."},{"title":"Financial news feed for a ticker","prompt":"Pull the latest financial news articles for Amazon (AMZN) from Finnhub — use the company news operation with AMZN as the symbol."}],"resultDescription":"Returns a JSON object with status, the upstream Finnhub response body under 'result', the operation name, api name, latency in milliseconds, cost as a string, and the upstream HTTP status code.","failureModes":["Invalid operation id returns error status with no result","Malformed JSON input payload causes upstream rejection","Unsupported Finnhub endpoint path returns 404 upstream_status","Insufficient USDC balance on x402 protocol causes 402 payment failure","Rate limiting by Finnhub upstream returns 429 upstream_status"],"whenToPreferThis":"Choose this endpoint when you need programmatic access to Finnhub's financial data (quotes, earnings, news, fundamentals) without managing your own Finnhub API key, and you prefer pay-per-call USDC micropayments over subscription billing. Ideal for agents that need occasional or burst financial data lookups without committing to a recurring subscription.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:31:58.565Z","isFirstParty":false}