{"openapi":"3.1.0","info":{"title":"Financial Modeling Prep (BYOK) API","version":"0.1.0","description":"Financial Modeling Prep (BYOK) lets an AI assistant read your own Financial Modeling Prep data through the Financial Modeling Prep API with a key you supply (API key). Read-only: 10 tools (get_quote, get_company_profile, get_income_statement, get_balance_sheet, get_cash_flow, get_key_metrics, get_financial_ratios, get_price_history, search_symbols, get_latest_stock_news). The BYOK key travels...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-financialmodelingprep.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-financialmodelingprep/docs"},"termsOfService":"https://connectorbay.com/byok-financialmodelingprep/terms"},"servers":[{"url":"https://byok-financialmodelingprep.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-financialmodelingprep/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 quote for one stock: price, change, volume and related market data. The provider's reference does not pub","description":"Get the latest quote for one stock: price, change, volume and related market data. The provider's reference does not publish the response fields, so the answer is passed through (capped); free plans cover a limited set of symbols and endpoints. Use for \"What is Apple's stock price right now\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"symbol":{"description":"Ticker symbol, for example AAPL.","maxLength":20,"title":"Symbol","type":"string"}},"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_company_profile":{"post":{"operationId":"get_company_profile","summary":"Get a company's profile: name, sector, industry, exchange, description, website and other company details. The provider'","description":"Get a company's profile: name, sector, industry, exchange, description, website and other company details. The provider's reference does not publish the response fields, so the answer is passed through (capped); free plans cover a limited set of symbols and endpoints. Use for \"Give me a profile of Apple Inc\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"symbol":{"description":"Ticker symbol, for example AAPL.","maxLength":20,"title":"Symbol","type":"string"}},"required":["symbol"],"title":"get_company_profileArguments","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_income_statement":{"post":{"operationId":"get_income_statement","summary":"Get a company's income statements (revenue, costs, profit, earnings per share). The provider's reference does not publis","description":"Get a company's income statements (revenue, costs, profit, earnings per share). The provider's reference does not publish the response fields, so the answer is passed through (capped); free plans cover a limited set of symbols and endpoints. Use for \"Show Apple's income statements\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"symbol":{"description":"Ticker symbol, for example AAPL.","maxLength":20,"title":"Symbol","type":"string"}},"required":["symbol"],"title":"get_income_statementArguments","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_balance_sheet":{"post":{"operationId":"get_balance_sheet","summary":"Get a company's balance sheet statements (assets, liabilities, equity). The provider's reference does not publish the re","description":"Get a company's balance sheet statements (assets, liabilities, equity). The provider's reference does not publish the response fields, so the answer is passed through (capped); free plans cover a limited set of symbols and endpoints. Use for \"Show Apple's balance sheet\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"symbol":{"description":"Ticker symbol, for example AAPL.","maxLength":20,"title":"Symbol","type":"string"}},"required":["symbol"],"title":"get_balance_sheetArguments","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_cash_flow":{"post":{"operationId":"get_cash_flow","summary":"Get a company's cash flow statements (operating, investing, financing cash flows). The provider's reference does not pub","description":"Get a company's cash flow statements (operating, investing, financing cash flows). The provider's reference does not publish the response fields, so the answer is passed through (capped); free plans cover a limited set of symbols and endpoints. Use for \"Show Apple's cash flow statements\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"symbol":{"description":"Ticker symbol, for example AAPL.","maxLength":20,"title":"Symbol","type":"string"}},"required":["symbol"],"title":"get_cash_flowArguments","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_key_metrics":{"post":{"operationId":"get_key_metrics","summary":"Get a company's key financial metrics per reporting period. The provider's reference does not publish the response field","description":"Get a company's key financial metrics per reporting period. The provider's reference does not publish the response fields, so the answer is passed through (capped); free plans cover a limited set of symbols and endpoints. Use for \"What are Apple's key financial metrics\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"symbol":{"description":"Ticker symbol, for example AAPL.","maxLength":20,"title":"Symbol","type":"string"}},"required":["symbol"],"title":"get_key_metricsArguments","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_financial_ratios":{"post":{"operationId":"get_financial_ratios","summary":"Get a company's financial ratios per reporting period. The provider's reference does not publish the response fields, so","description":"Get a company's financial ratios per reporting period. The provider's reference does not publish the response fields, so the answer is passed through (capped); free plans cover a limited set of symbols and endpoints. Use for \"What are Apple's financial ratios\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"symbol":{"description":"Ticker symbol, for example AAPL.","maxLength":20,"title":"Symbol","type":"string"}},"required":["symbol"],"title":"get_financial_ratiosArguments","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_price_history":{"post":{"operationId":"get_price_history","summary":"Get daily end-of-day price history for a stock: open, high, low, close, volume, change and VWAP. The provider's referenc","description":"Get daily end-of-day price history for a stock: open, high, low, close, volume, change and VWAP. The provider's reference does not publish the response fields, so the answer is passed through (capped); free plans cover a limited set of symbols and endpoints. Use for \"Show Apple's daily price history\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"symbol":{"description":"Ticker symbol, for example AAPL.","maxLength":20,"title":"Symbol","type":"string"}},"required":["symbol"],"title":"get_price_historyArguments","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 symbol; returns symbol, company name, exchange and currency. The provider's","description":"Search for ticker symbols by company name or symbol; returns symbol, company name, exchange and currency. The provider's reference does not publish the response fields, so the answer is passed through (capped); free plans cover a limited set of symbols and endpoints. Use for \"What is the ticker for Tesla\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Company name or symbol to search for, for example 'tesla' or 'AAPL'.","maxLength":100,"title":"Query","type":"string"}},"required":["query"],"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_latest_stock_news":{"post":{"operationId":"get_latest_stock_news","summary":"Get the latest stock market news articles, paged. The provider's reference does not publish the response fields, so the ","description":"Get the latest stock market news articles, paged. The provider's reference does not publish the response fields, so the answer is passed through (capped); free plans cover a limited set of symbols and endpoints. Use for \"What is the latest stock market news\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"page":{"anyOf":[{"maximum":100,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Page number, starting at 0.","title":"Page"},"limit":{"anyOf":[{"maximum":250,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many articles to return per page.","title":"Limit"}},"title":"get_latest_stock_newsArguments","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}}}}