{"openapi":"3.1.0","info":{"title":"Tiingo (BYOK) API","version":"0.1.0","description":"Tiingo (BYOK) lets an AI assistant read your own Tiingo data through the Tiingo API with a key you supply (Tiingo API token). Read-only: 8 tools (get_ticker_metadata, get_latest_price, get_historical_prices, get_iex_quote, get_iex_intraday_prices, get_crypto_prices, search_tickers, get_news). The BYOK key travels with each request, is used for that one call only and is never stored, logged or...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-tiingo.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-tiingo/docs"},"termsOfService":"https://connectorbay.com/byok-tiingo/terms"},"servers":[{"url":"https://byok-tiingo.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-tiingo/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_ticker_metadata":{"post":{"operationId":"get_ticker_metadata","summary":"Get a ticker's name, exchange, description and the first and last dates Tiingo has end-of-day data for. Use for \"What co","description":"Get a ticker's name, exchange, description and the first and last dates Tiingo has end-of-day data for. Use for \"What company is the ticker AAPL and since when does Tiingo have price data\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"ticker":{"description":"Ticker symbol, for example 'aapl' or 'AAPL' (stocks, ETFs and mutual funds).","maxLength":20,"title":"Ticker","type":"string"}},"required":["ticker"],"title":"get_ticker_metadataArguments","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_price":{"post":{"operationId":"get_latest_price","summary":"Get the most recent end-of-day price bar of a ticker: open, high, low, close, volume and adjusted values. Use for \"What ","description":"Get the most recent end-of-day price bar of a ticker: open, high, low, close, volume and adjusted values. Use for \"What was Apple's last closing price\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"ticker":{"description":"Ticker symbol, for example 'aapl' or 'AAPL' (stocks, ETFs and mutual funds).","maxLength":20,"title":"Ticker","type":"string"}},"required":["ticker"],"title":"get_latest_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_historical_prices":{"post":{"operationId":"get_historical_prices","summary":"Get daily (or weekly, monthly, annual) end-of-day price bars for a ticker between two dates, raw and split/dividend adju","description":"Get daily (or weekly, monthly, annual) end-of-day price bars for a ticker between two dates, raw and split/dividend adjusted. Shows at most 200 bars; narrow the dates for more. Use for \"Show Apple's daily closing prices for September 2026\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"ticker":{"description":"Ticker symbol, for example 'aapl' or 'AAPL' (stocks, ETFs and mutual funds).","maxLength":20,"title":"Ticker","type":"string"},"start_date":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"First date, YYYY-MM-DD.","title":"Start Date"},"end_date":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Last date, YYYY-MM-DD.","title":"End Date"},"resample_freq":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Bar size, for example monthly (default daily).","title":"Resample Freq"}},"required":["ticker"],"title":"get_historical_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_iex_quote":{"post":{"operationId":"get_iex_quote","summary":"Get the latest intraday quote of a US stock from the IEX feed: last price, previous close, open, high, low and volume. B","description":"Get the latest intraday quote of a US stock from the IEX feed: last price, previous close, open, high, low and volume. Bid, ask and last-sale fields are empty unless the account has an IEX entitlement. Use for \"What is Apple's price right now\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"ticker":{"description":"Ticker symbol, for example 'aapl' or 'AAPL' (stocks, ETFs and mutual funds).","maxLength":20,"title":"Ticker","type":"string"}},"required":["ticker"],"title":"get_iex_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_iex_intraday_prices":{"post":{"operationId":"get_iex_intraday_prices","summary":"Get intraday price bars of a US stock from the IEX feed from a start date, at a chosen bar size. Shows at most 200 bars.","description":"Get intraday price bars of a US stock from the IEX feed from a start date, at a chosen bar size. Shows at most 200 bars. Use for \"Show Apple's 5-minute prices for today\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"ticker":{"description":"Ticker symbol, for example 'aapl' or 'AAPL' (stocks, ETFs and mutual funds).","maxLength":20,"title":"Ticker","type":"string"},"start_date":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"First date, YYYY-MM-DD.","title":"Start Date"},"resample_freq":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Bar size, for example 5min.","title":"Resample Freq"}},"required":["ticker"],"title":"get_iex_intraday_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_crypto_prices":{"post":{"operationId":"get_crypto_prices","summary":"Get crypto price bars (open, high, low, close, volume, trades) for one or more pairs such as btcusd from a start date. S","description":"Get crypto price bars (open, high, low, close, volume, trades) for one or more pairs such as btcusd from a start date. Shows at most 50 pairs. Use for \"What was the Bitcoin price today\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"tickers":{"description":"Comma-separated crypto pairs, for example 'btcusd,ethusd'.","maxLength":200,"title":"Tickers","type":"string"},"start_date":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"First date, YYYY-MM-DD.","title":"Start Date"},"resample_freq":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Bar size, for example 5min.","title":"Resample Freq"}},"required":["tickers"],"title":"get_crypto_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_tickers":{"post":{"operationId":"search_tickers","summary":"Search Tiingo for tickers by company name or symbol; returns ticker, name, asset type and whether it is still actively q","description":"Search Tiingo for tickers by company name or symbol; returns ticker, name, asset type and whether it is still actively quoted. Tiingo marks this endpoint as beta. Use for \"What is the ticker symbol of Tesla\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Company name or ticker text to search for.","maxLength":100,"title":"Query","type":"string"}},"required":["query"],"title":"search_tickersArguments","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_news":{"post":{"operationId":"get_news","summary":"Get recent financial news articles with title, source, publish time, summary and the tickers they mention, optionally fo","description":"Get recent financial news articles with title, source, publish time, summary and the tickers they mention, optionally for chosen tickers. The News API may not be part of every Tiingo plan. Use for \"What is the latest news about Apple and Google\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"tickers":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated ticker symbols to limit to, for example 'aapl,googl'.","title":"Tickers"},"sort_by":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Field to sort by, for example crawlDate (the time Tiingo found the article).","title":"Sort By"}},"title":"get_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}}}}