{"openapi":"3.0.3","info":{"title":"Gnist Context — Alpha Vantage (Finance)","description":"Stock quotes, historical OHLCV, FX rates, and crypto prices.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/alpha-vantage/`\n- **Toolkit page:** `/toolkits/alpha-vantage`\n- **Full API spec:** `/api/openapi.json`\n- **Get an API key:** `/signup`","version":"1.0.0","contact":{"name":"GnistAI","url":"https://gnist.ai"}},"servers":[{"url":"https://context.gnist.ai","description":"Production"}],"paths":{"/rest/alpha-vantage/get_price":{"post":{"tags":["Finance"],"summary":"get_price","description":"Get the latest market quote for a stock or ETF.\n\nUses Alpha Vantage (requires ALPHA_VANTAGE_API_KEY env var).\n\nArgs:\n    ticker: Stock ticker symbol (e.g. \"AAPL\", \"TSLA\", \"SPY\").\n\nReturns:\n    Latest price, open/high/low, volume, previous close, and change %.","operationId":"alpha_vantage_get_price","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"ticker":{"description":"Stock ticker symbol (e.g. \"AAPL\", \"TSLA\", \"SPY\").","type":"string"}},"required":["ticker"],"type":"object"}}}}}},"/rest/alpha-vantage/get_historical":{"post":{"tags":["Finance"],"summary":"get_historical","description":"Get historical OHLCV data for a stock or ETF.\n\nArgs:\n    ticker: Stock ticker symbol (e.g. \"AAPL\", \"MSFT\").\n    start: Start date in YYYY-MM-DD format (inclusive).\n    end: End date in YYYY-MM-DD format (inclusive).\n    interval: Data interval — \"daily\", \"weekly\", or \"monthly\" (default: \"daily\").\n\nReturns:\n    Symbol, interval, count, and list of OHLCV entries (open, high, low, close, volume).","operationId":"alpha_vantage_get_historical","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"ticker":{"description":"Stock ticker symbol (e.g. \"AAPL\", \"MSFT\").","type":"string"},"start":{"description":"Start date in YYYY-MM-DD format (inclusive).","type":"string"},"end":{"description":"End date in YYYY-MM-DD format (inclusive).","type":"string"},"interval":{"default":"daily","description":"Data interval — \"daily\", \"weekly\", or \"monthly\" (default: \"daily\").","type":"string"}},"required":["ticker","start","end"],"type":"object"}}}}}},"/rest/alpha-vantage/get_fx_rate":{"post":{"tags":["Finance"],"summary":"get_fx_rate","description":"Get the daily exchange rate between two currencies.\n\nUses ECB reference rates (updated daily ~16:00 CET on business days).\nSupports all major currencies. Cross-rates are derived from EUR-based data.\n\nArgs:\n    base: Base currency ISO 4217 code (e.g. \"USD\", \"EUR\", \"GBP\").\n    quote: Quote currency ISO 4217 code (e.g. \"NOK\", \"JPY\", \"CHF\").\n\nReturns:\n    Exchange rate (1 base = N quote), with the ECB reference date.","operationId":"alpha_vantage_get_fx_rate","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"base":{"description":"Base currency ISO 4217 code (e.g. \"USD\", \"EUR\", \"GBP\").","type":"string"},"quote":{"description":"Quote currency ISO 4217 code (e.g. \"NOK\", \"JPY\", \"CHF\").","type":"string"}},"required":["base","quote"],"type":"object"}}}}}},"/rest/alpha-vantage/get_crypto_price":{"post":{"tags":["Finance"],"summary":"get_crypto_price","description":"Get the current price and market data for a cryptocurrency.\n\nAccepts common ticker symbols (e.g. \"BTC\", \"ETH\", \"SOL\") or CoinGecko IDs\n(e.g. \"bitcoin\", \"ethereum\"). Prices are in USD via CoinGecko's free API.\n\nArgs:\n    symbol: Cryptocurrency symbol (e.g. \"BTC\") or CoinGecko ID (e.g. \"bitcoin\").\n\nReturns:\n    Current USD price, market cap, and 24-hour change percentage.","operationId":"alpha_vantage_get_crypto_price","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"symbol":{"description":"Cryptocurrency symbol (e.g. \"BTC\") or CoinGecko ID (e.g. \"bitcoin\").","type":"string"}},"required":["symbol"],"type":"object"}}}}}},"/rest/alpha-vantage/report_feedback":{"post":{"tags":["Finance"],"summary":"report_feedback","description":"Report a bug, feature request, or general feedback for this data source.\n\nUse this when something doesn't work as expected, when you'd like\na new feature, or when you have suggestions for improvement.\n\nArgs:\n    feedback: Describe the issue or suggestion.\n    feedback_type: One of 'bug', 'feature_request', or 'general'.","operationId":"alpha_vantage_report_feedback","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"feedback":{"type":"string"},"feedback_type":{"default":"general","type":"string"}},"required":["feedback"],"type":"object"}}}}}}},"tags":[{"name":"Finance","description":"Data sources: Finance"}],"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"gnist-api-key","description":"API key passed via request header."},"ApiKeyQuery":{"type":"apiKey","in":"query","name":"gnist_api_key","description":"API key passed via query parameter."}}}}