{"openapi":"3.1.0","info":{"title":"Intrinio (BYOK) API","version":"0.1.0","description":"Intrinio (BYOK) lets an AI assistant read your own Intrinio data through the Intrinio API with a key you supply (Intrinio API key). Read-only: 12 tools (search_securities, get_security, get_stock_prices, get_realtime_price, get_latest_dividend, get_latest_earnings, search_companies, get_company, get_company_news, list_company_fundamentals, get_standardized_financials,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-intrinio.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-intrinio/docs"},"termsOfService":"https://connectorbay.com/byok-intrinio/terms"},"servers":[{"url":"https://byok-intrinio.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-intrinio/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/search_securities":{"post":{"operationId":"search_securities","summary":"Search securities by text matched against ticker and name; returns id, name, tickers, FIGI, exchange and primary-listing","description":"Search securities by text matched against ticker and name; returns id, name, tickers, FIGI, exchange and primary-listing flag. Use for \"Find the security with ticker or name matching 'apple'\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Text to match against ticker and security name.","maxLength":100,"title":"Query","type":"string"},"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"Results to return (1 to 100).","title":"Page Size"}},"required":["query"],"title":"search_securitiesArguments","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_security":{"post":{"operationId":"get_security","summary":"Get security reference data: name, tickers, FIGI, CIK, currency, ETF and active flags, listing exchange and first and la","description":"Get security reference data: name, tickers, FIGI, CIK, currency, ETF and active flags, listing exchange and first and last price dates. Use for \"What is the FIGI and listing exchange of AAPL\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"identifier":{"description":"Security identifier: ticker (AAPL), FIGI, ISIN, CUSIP or Intrinio id.","maxLength":40,"title":"Identifier","type":"string"}},"required":["identifier"],"title":"get_securityArguments","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_stock_prices":{"post":{"operationId":"get_stock_prices","summary":"Get end-of-day stock prices for a security: open, high, low, close, volume, adjusted close and change, daily or weekly t","description":"Get end-of-day stock prices for a security: open, high, low, close, volume, adjusted close and change, daily or weekly to yearly. Use for \"Show Apple's daily closing prices for January 2026\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"identifier":{"description":"Security identifier: ticker (AAPL), FIGI, ISIN, CUSIP or Intrinio id.","maxLength":40,"title":"Identifier","type":"string"},"start_date":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Only prices on or after this date, YYYY-MM-DD.","title":"Start Date"},"end_date":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Only prices on or before this date, YYYY-MM-DD.","title":"End Date"},"frequency":{"anyOf":[{"enum":["daily","weekly","monthly","quarterly","yearly"],"type":"string"},{"type":"null"}],"default":"daily","description":"Price period: daily, weekly, monthly, quarterly or yearly.","title":"Frequency"},"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"Results per page (1 to 100).","title":"Page Size"},"next_page":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Value of next_page from the previous response, to get the following page.","title":"Next Page"}},"required":["identifier"],"title":"get_stock_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_realtime_price":{"post":{"operationId":"get_realtime_price","summary":"Get the latest stock price for a security: last trade price and time, bid, ask, day high and low and volume. Needs a pla","description":"Get the latest stock price for a security: last trade price and time, bid, ask, day high and low and volume. Needs a plan with realtime or delayed prices. Use for \"What is the latest price of AAPL\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"identifier":{"description":"Security identifier: ticker (AAPL), FIGI, ISIN, CUSIP or Intrinio id.","maxLength":40,"title":"Identifier","type":"string"},"source":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated data sources to use; leave out for the best one available.","title":"Source"}},"required":["identifier"],"title":"get_realtime_priceArguments","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_dividend":{"post":{"operationId":"get_latest_dividend","summary":"Get the latest dividend record of a security: amount, currency, announcement, record and pay dates, frequency and forwar","description":"Get the latest dividend record of a security: amount, currency, announcement, record and pay dates, frequency and forward yield. Use for \"When does Apple pay its next dividend\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"identifier":{"description":"Security identifier: ticker (AAPL), FIGI, ISIN, CUSIP or Intrinio id.","maxLength":40,"title":"Identifier","type":"string"}},"required":["identifier"],"title":"get_latest_dividendArguments","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_earnings":{"post":{"operationId":"get_latest_earnings","summary":"Get the latest and next earnings dates of a security: quarter, conference call date, quarterly dates and next earnings d","description":"Get the latest and next earnings dates of a security: quarter, conference call date, quarterly dates and next earnings date. Use for \"When does Apple report earnings next\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"identifier":{"description":"Security identifier: ticker (AAPL), FIGI, ISIN, CUSIP or Intrinio id.","maxLength":40,"title":"Identifier","type":"string"}},"required":["identifier"],"title":"get_latest_earningsArguments","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_companies":{"post":{"operationId":"search_companies","summary":"Search companies by text matched against ticker and name; returns id, ticker, name, LEI and CIK. Use for \"Find the compa","description":"Search companies by text matched against ticker and name; returns id, ticker, name, LEI and CIK. Use for \"Find the company record for Microsoft\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Text to match against company ticker and name.","maxLength":100,"title":"Query","type":"string"},"active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True for actively traded companies only, False for inactive ones; leave out for both.","title":"Active"},"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"Results to return (1 to 100).","title":"Page Size"}},"required":["query"],"title":"search_companiesArguments","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":{"post":{"operationId":"get_company","summary":"Get a company profile: name, ticker, CIK, sector, industry, exchange, CEO, employees, headquarters, website and a busine","description":"Get a company profile: name, ticker, CIK, sector, industry, exchange, CEO, employees, headquarters, website and a business description. Use for \"Give me a profile of Apple: sector, employees and CEO\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"identifier":{"description":"Company identifier: ticker (AAPL), CIK, LEI or Intrinio id.","maxLength":40,"title":"Identifier","type":"string"}},"required":["identifier"],"title":"get_companyArguments","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_news":{"post":{"operationId":"get_company_news","summary":"List recent news articles for a company with title, source, date, link, summary and sentiment. Defaults to news since ye","description":"List recent news articles for a company with title, source, date, link, summary and sentiment. Defaults to news since yesterday. Use for \"What news was published about Apple recently\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"identifier":{"description":"Company identifier: ticker (AAPL), CIK, LEI or Intrinio id.","maxLength":40,"title":"Identifier","type":"string"},"start_date":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Only articles on or after this date, YYYY-MM-DD (default yesterday).","title":"Start Date"},"end_date":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Only articles on or before this date, YYYY-MM-DD.","title":"End Date"},"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"Articles per page (1 to 100).","title":"Page Size"},"next_page":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Value of next_page from the previous response, to get the following page.","title":"Next Page"}},"required":["identifier"],"title":"get_company_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}},"/v1/tools/list_company_fundamentals":{"post":{"operationId":"list_company_fundamentals","summary":"List a company's fundamentals records (statement type, fiscal year and period, dates, filing date) with the ids that get","description":"List a company's fundamentals records (statement type, fiscal year and period, dates, filing date) with the ids that get_standardized_financials needs. Use for \"Which fiscal periods of Apple's income statements are available\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"identifier":{"description":"Company identifier: ticker (AAPL), CIK, LEI or Intrinio id.","maxLength":40,"title":"Identifier","type":"string"},"fiscal_year":{"anyOf":[{"maximum":2100,"minimum":1950,"type":"integer"},{"type":"null"}],"default":null,"description":"Only this fiscal year, for example 2025.","title":"Fiscal Year"},"statement_code":{"anyOf":[{"enum":["income_statement","balance_sheet_statement","cash_flow_statement"],"type":"string"},{"type":"null"}],"default":null,"description":"Statement: income_statement, balance_sheet_statement or cash_flow_statement.","title":"Statement Code"},"latest_only":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True for only the most recently reported fundamental of each period.","title":"Latest Only"},"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"Results per page (1 to 100).","title":"Page Size"},"next_page":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Value of next_page from the previous response, to get the following page.","title":"Next Page"}},"required":["identifier"],"title":"list_company_fundamentalsArguments","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_standardized_financials":{"post":{"operationId":"get_standardized_financials","summary":"Get the standardized financial statement lines (income statement, balance sheet or cash flow) of one fundamentals record","description":"Get the standardized financial statement lines (income statement, balance sheet or cash flow) of one fundamentals record, as data tag names with values. Use for \"Show Apple's standardized income statement for fiscal 2025\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"id":{"description":"Fundamental id from list_company_fundamentals, or a lookup code such as AAPL-income_statement-2025-FY.","maxLength":80,"title":"Id","type":"string"}},"required":["id"],"title":"get_standardized_financialsArguments","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_historical_data":{"post":{"operationId":"get_company_historical_data","summary":"Get the history of one financial data tag (for example marketcap or revenue) for a company over time. Use for \"How has A","description":"Get the history of one financial data tag (for example marketcap or revenue) for a company over time. Use for \"How has Apple's market cap changed this year\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"identifier":{"description":"Company identifier: ticker (AAPL), CIK, LEI or Intrinio id.","maxLength":40,"title":"Identifier","type":"string"},"tag":{"description":"Intrinio data tag code, for example marketcap, revenue or netincome.","maxLength":80,"title":"Tag","type":"string"},"frequency":{"anyOf":[{"enum":["daily","weekly","monthly","quarterly","yearly"],"type":"string"},{"type":"null"}],"default":"daily","description":"Period: daily, weekly, monthly, quarterly or yearly.","title":"Frequency"},"start_date":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Only values on or after this date, YYYY-MM-DD.","title":"Start Date"},"end_date":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Only values on or before this date, YYYY-MM-DD.","title":"End Date"},"sort_order":{"anyOf":[{"enum":["asc","desc"],"type":"string"},{"type":"null"}],"default":"desc","description":"Date order: asc or desc.","title":"Sort Order"},"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"Results per page (1 to 100).","title":"Page Size"},"next_page":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Value of next_page from the previous response, to get the following page.","title":"Next Page"}},"required":["identifier","tag"],"title":"get_company_historical_dataArguments","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}}}}