{"openapi":"3.1.0","info":{"title":"Alpha Vantage (BYOK) API","version":"0.1.0","description":"Alpha Vantage (BYOK) lets an AI assistant read your own Alpha Vantage data through the Alpha Vantage API with a key you supply (API key). Read-only: 6 tools (get_quote, get_daily_prices, get_weekly_prices, get_monthly_prices, search_symbols, get_market_status). The BYOK key travels with each request, is used for that one call only and is never stored, logged or cached; it is only ever sent to...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-alphavantage.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-alphavantage/docs"},"termsOfService":"https://connectorbay.com/byok-alphavantage/terms"},"servers":[{"url":"https://byok-alphavantage.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-alphavantage/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/get_quote":{"post":{"operationId":"get_quote","summary":"Get the latest price quote for one ticker: open, high, low, price, volume, previous close and change. By default the quo","description":"Get the latest price quote for one ticker: open, high, low, price, volume, previous close and change. By default the quote updates at the end of each trading day; real-time US data needs a premium plan. Free keys are limited to 25 requests per day, and the provider answers with a notice instead of data when the limit is reached. Use for \"What is IBM's latest stock price\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"symbol":{"description":"Ticker symbol, for example IBM. Non-US listings carry an exchange suffix such as TSCO.LON, SHOP.TRT or RELIANCE.BSE; use search_symbols to find the right one.","maxLength":30,"title":"Symbol","type":"string"},"function":{"anyOf":[{"const":"GLOBAL_QUOTE","type":"string"},{"type":"null"}],"default":"GLOBAL_QUOTE","description":"Fixed by this tool; do not change.","title":"Function"}},"required":["symbol"],"title":"get_quoteArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_daily_prices":{"post":{"operationId":"get_daily_prices","summary":"Get daily open, high, low, close and volume for one ticker, newest first, for the latest 100 trading days. Free keys are","description":"Get daily open, high, low, close and volume for one ticker, newest first, for the latest 100 trading days. Free keys are limited to 25 requests per day, and the provider answers with a notice instead of data when the limit is reached. Use for \"Show IBM's daily closing prices for the last few months\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"symbol":{"description":"Ticker symbol, for example IBM. Non-US listings carry an exchange suffix such as TSCO.LON, SHOP.TRT or RELIANCE.BSE; use search_symbols to find the right one.","maxLength":30,"title":"Symbol","type":"string"},"function":{"anyOf":[{"const":"TIME_SERIES_DAILY","type":"string"},{"type":"null"}],"default":"TIME_SERIES_DAILY","description":"Fixed by this tool; do not change.","title":"Function"}},"required":["symbol"],"title":"get_daily_pricesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_weekly_prices":{"post":{"operationId":"get_weekly_prices","summary":"Get weekly open, high, low, close and volume for one ticker over 20+ years, dated on the last trading day of each week. ","description":"Get weekly open, high, low, close and volume for one ticker over 20+ years, dated on the last trading day of each week. The answer is long and may be cut off. Free keys are limited to 25 requests per day, and the provider answers with a notice instead of data when the limit is reached. Use for \"Show IBM's weekly prices over the long term\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"symbol":{"description":"Ticker symbol, for example IBM. Non-US listings carry an exchange suffix such as TSCO.LON, SHOP.TRT or RELIANCE.BSE; use search_symbols to find the right one.","maxLength":30,"title":"Symbol","type":"string"},"function":{"anyOf":[{"const":"TIME_SERIES_WEEKLY","type":"string"},{"type":"null"}],"default":"TIME_SERIES_WEEKLY","description":"Fixed by this tool; do not change.","title":"Function"}},"required":["symbol"],"title":"get_weekly_pricesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_monthly_prices":{"post":{"operationId":"get_monthly_prices","summary":"Get monthly open, high, low, close and volume for one ticker over 20+ years, dated on the last trading day of each month","description":"Get monthly open, high, low, close and volume for one ticker over 20+ years, dated on the last trading day of each month. Free keys are limited to 25 requests per day, and the provider answers with a notice instead of data when the limit is reached. Use for \"Show IBM's monthly prices over the past decades\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"symbol":{"description":"Ticker symbol, for example IBM. Non-US listings carry an exchange suffix such as TSCO.LON, SHOP.TRT or RELIANCE.BSE; use search_symbols to find the right one.","maxLength":30,"title":"Symbol","type":"string"},"function":{"anyOf":[{"const":"TIME_SERIES_MONTHLY","type":"string"},{"type":"null"}],"default":"TIME_SERIES_MONTHLY","description":"Fixed by this tool; do not change.","title":"Function"}},"required":["symbol"],"title":"get_monthly_pricesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/search_symbols":{"post":{"operationId":"search_symbols","summary":"Search for ticker symbols by company name or keywords; returns best matches with symbol, name, type, region and match sc","description":"Search for ticker symbols by company name or keywords; returns best matches with symbol, name, type, region and match score. Free keys are limited to 25 requests per day, and the provider answers with a notice instead of data when the limit is reached. Use for \"What is the ticker symbol for Microsoft\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"keywords":{"description":"Company name or symbol fragment to search for, for example 'microsoft'.","maxLength":100,"title":"Keywords","type":"string"},"function":{"anyOf":[{"const":"SYMBOL_SEARCH","type":"string"},{"type":"null"}],"default":"SYMBOL_SEARCH","description":"Fixed by this tool; do not change.","title":"Function"}},"required":["keywords"],"title":"search_symbolsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_market_status":{"post":{"operationId":"get_market_status","summary":"Show whether the major stock, forex and crypto trading venues worldwide are open or closed right now. Free keys are limi","description":"Show whether the major stock, forex and crypto trading venues worldwide are open or closed right now. Free keys are limited to 25 requests per day, and the provider answers with a notice instead of data when the limit is reached. Use for \"Are the stock markets open right now\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"function":{"anyOf":[{"const":"MARKET_STATUS","type":"string"},{"type":"null"}],"default":"MARKET_STATUS","description":"Fixed by this tool; do not change.","title":"Function"}},"title":"get_market_statusArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}