{"openapi":"3.1.0","info":{"title":"TradingView API (Bowmark)","version":"e833508f87ff","description":"Charting, symbol search and market data from TradingView.\n\nEvery function Bowmark has for TradingView (www.tradingview.com) as one HTTP call. Each runs on Bowmark's infrastructure with the same billing, rules and response envelope as `POST /v1/run`. The whole API: https://api.bowmark.ai/openapi.json. Guide: https://bowmark.ai/docs/api.","contact":{"email":"support@bowmark.ai","url":"https://bowmark.ai/docs/api"}},"servers":[{"url":"https://api.bowmark.ai"}],"security":[{"bearer":[]},{"apiKeyHeader":[]}],"paths":{"/v1/sites/tradingview/searchSymbols":{"post":{"operationId":"searchSymbols","summary":"Searches TradingView for a symbol by ticker, company name, or description across all exchanges — the same lookup TradingView's own search box runs.","description":"Searches TradingView for a symbol by ticker, company name, or description across all exchanges — the same lookup TradingView's own search box runs. Returns every matching symbol with its name, exchange, instrument type, and (when TradingView carries them) ISIN/CUSIP. `exchange` is the prefix TradingView itself uses in `EXCHANGE:SYMBOL`, so it can be passed straight to the other functions. `query` is free text, e.g. \"AAPL\" or \"Apple\". Use a result's `symbol` to call `getQuote`.\n\nCalls `bowmark.providers.tradingview.searchSymbols`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<SymbolSearchResult[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"TypeScript: `string`"}},"required":["query"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/tradingview/getQuote":{"post":{"operationId":"getQuote","summary":"Gets the current session price, change, and key metrics for one symbol on one exchange — e.g.","description":"Gets the current session price, change, and key metrics for one symbol on one exchange — e.g. `getQuote(\"NASDAQ\", \"AAPL\")`. Use `searchSymbols` first and pass its exact `exchange` and `symbol` fields. `price` is the current/last-session price and `changePercent`/`changeAbsolute` are against the prior close; TradingView's live tick-by-tick feed only exists over its websocket and is not carried here. Also returns OHLCV, market cap, sector/industry, P/E, dividend yield, 52-week high/low and beta where TradingView carries them.\n\nCalls `bowmark.providers.tradingview.getQuote`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<Quote>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"exchange":{"type":"string","description":"TypeScript: `string`"},"symbol":{"type":"string","description":"TypeScript: `string`"}},"required":["exchange","symbol"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/tradingview/getCompanyInfo":{"post":{"operationId":"getCompanyInfo","summary":"Gets company information for one symbol on one exchange — e.g.","description":"Gets company information for one symbol on one exchange — e.g. `getCompanyInfo(\"NASDAQ\", \"AAPL\")`. Use `searchSymbols` first and pass its exact `exchange` and `symbol` fields. Returns the company name, description, instrument type, business sector and industry classification, market cap, P/E ratio, dividend yield, and a numerical analyst recommendation score (higher = more bullish). An unknown or delisted pair returns a caller-fixable error.\n\nCalls `bowmark.providers.tradingview.getCompanyInfo`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<CompanyInfo>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"exchange":{"type":"string","description":"TypeScript: `string`"},"symbol":{"type":"string","description":"TypeScript: `string`"}},"required":["exchange","symbol"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/tradingview/getNews":{"post":{"operationId":"getNews","summary":"Gets recent news headlines for one symbol — e.g.","description":"Gets recent news headlines for one symbol — e.g. `getNews(\"NASDAQ\", \"AAPL\")` — the same feed TradingView's own symbol page renders. Use `searchSymbols` first and pass its exact `exchange` and `symbol` fields. Each item carries the headline, its source, a Unix `published` timestamp, an `urgency` score, a `link` (the original publisher's article where TradingView carries one, else TradingView's own story page), and every symbol the item is tagged against. An unknown or delisted pair returns an empty list rather than an error.\n\nCalls `bowmark.providers.tradingview.getNews`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<NewsItem[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"exchange":{"type":"string","description":"TypeScript: `string`"},"symbol":{"type":"string","description":"TypeScript: `string`"}},"required":["exchange","symbol"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/tradingview/getTechnicalAnalysis":{"post":{"operationId":"getTechnicalAnalysis","summary":"Gets technical analysis signals for one symbol — e.g.","description":"Gets technical analysis signals for one symbol — e.g. `getTechnicalAnalysis(\"NASDAQ\", \"AAPL\")` — the same summary TradingView's own Technical Analysis widget renders. Use `searchSymbols` first and pass its exact `exchange` and `symbol` fields. Returns a `summaryRecommendation` (\"Strong Sell\" .. \"Strong Buy\", folding moving averages and oscillators together) plus its numeric `summaryScore` in [-1, 1], the same pair split into `movingAverageRecommendation`/`movingAverageScore` and `oscillatorRecommendation`/`oscillatorScore`, and the underlying `movingAverages` (SMA/EMA at 10/20/50/100/200) and `oscillators` (RSI, stochastic, CCI, ADX, Awesome Oscillator, momentum, MACD, Williams %R, Ultimate Oscillator, Bull Bear Power) TradingView computed them from. This is TradingView's own technical rating, not an analyst consensus. An unknown or delisted pair returns a caller-fixable error.\n\nCalls `bowmark.providers.tradingview.getTechnicalAnalysis`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<TechnicalAnalysis>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"exchange":{"type":"string","description":"TypeScript: `string`"},"symbol":{"type":"string","description":"TypeScript: `string`"}},"required":["exchange","symbol"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/tradingview/getFinancials":{"post":{"operationId":"getFinancials","summary":"Gets financial statement data for one symbol on one exchange — e.g.","description":"Gets financial statement data for one symbol on one exchange — e.g. `getFinancials(\"NASDAQ\", \"AAPL\")` — the same scanner door as `getQuote`/`getCompanyInfo`. Use `searchSymbols` first and pass its exact `exchange` and `symbol` fields. Returns trailing-twelve-month income-statement figures (`totalRevenue`, `grossProfit`, `netIncome`, `ebitda`, `earningsPerShare`, `freeCashFlow`, plus `revenueGrowthYoy`/`netIncomeGrowthYoy` where TradingView carries them) and the most recent fiscal quarter's balance sheet (`totalAssets`, `totalCurrentAssets`, `totalLiabilities`, `totalCurrentLiabilities`, `totalDebt`, `cashAndEquivalents`) — TradingView carries no TTM balance sheet, since a balance sheet is a point-in-time snapshot rather than something to sum over four quarters. An unknown or delisted pair returns a caller-fixable error.\n\nCalls `bowmark.providers.tradingview.getFinancials`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<Financials>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"exchange":{"type":"string","description":"TypeScript: `string`"},"symbol":{"type":"string","description":"TypeScript: `string`"}},"required":["exchange","symbol"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/tradingview/getChartData":{"post":{"operationId":"getChartData","summary":"Gets historical OHLCV candlesticks for one symbol on one exchange — e.g.","description":"Gets historical OHLCV candlesticks for one symbol on one exchange — e.g. `getChartData(\"NASDAQ\", \"AAPL\")` for the last 30 daily bars, or `getChartData(\"NASDAQ\", \"AAPL\", { interval: \"W\", bars: 52 })` for a year of weekly ones. `interval` is minutes as digits (`\"1\"` .. `\"240\"`), `\"D\"`, `\"W\"` or `\"M\"`, defaulting to `\"D\"`; `bars` is how many of the most recent bars to return, 1-5000, defaulting to 30. Use `searchSymbols` first and pass its exact `exchange` and `symbol` fields. Returns `{ symbol, exchange, interval, bars }`, where every entry in `bars` carries its Unix-seconds `time`, open, high, low, close and volume, in ascending time order — e.g. `bars.at(-1).close` is the latest close. An unknown or delisted pair returns a caller-fixable error.\n\nCalls `bowmark.providers.tradingview.getChartData`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<ChartData>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"exchange":{"type":"string","description":"TypeScript: `string`"},"symbol":{"type":"string","description":"TypeScript: `string`"},"options":{"type":"object","properties":{"interval":{"anyOf":[{"const":"1"},{"const":"3"},{"const":"5"},{"const":"15"},{"const":"30"},{"const":"45"},{"const":"60"},{"const":"120"},{"const":"180"},{"const":"240"},{"const":"D"},{"const":"W"},{"const":"M"}]},"bars":{"type":"number"}},"additionalProperties":true,"description":"TypeScript: `{ interval?: \"1\" | \"3\" | \"5\" | \"15\" | \"30\" | \"45\" | \"60\" | \"120\" | \"180\" | \"240\" | \"D\" | \"W\" | \"M\", bars?: number }`"}},"required":["exchange","symbol"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/tradingview/getEarnings":{"post":{"operationId":"getEarnings","summary":"Gets earnings history and the upcoming earnings date for one symbol on one exchange — e.g.","description":"Gets earnings history and the upcoming earnings date for one symbol on one exchange — e.g. `getEarnings(\"NASDAQ\", \"AAPL\")` — the same scanner door as `getQuote`/`getFinancials`. Use `searchSymbols` first and pass its exact `exchange` and `symbol` fields. Returns `lastReleaseDate`/`nextReleaseDate` (Unix seconds), the most recently reported quarter's `epsActual` vs. analyst `epsEstimate` and the `epsSurprise`/`epsSurprisePercent` between them, plus `epsEstimateNextQuarter` and `revenueEstimateNextQuarter` for the quarter not yet reported. An unknown or delisted pair returns a caller-fixable error.\n\nCalls `bowmark.providers.tradingview.getEarnings`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<Earnings>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"exchange":{"type":"string","description":"TypeScript: `string`"},"symbol":{"type":"string","description":"TypeScript: `string`"}},"required":["exchange","symbol"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/tradingview/getDividends":{"post":{"operationId":"getDividends","summary":"Gets dividend history and yield information for one symbol on one exchange — e.g.","description":"Gets dividend history and yield information for one symbol on one exchange — e.g. `getDividends(\"NASDAQ\", \"AAPL\")` — the same scanner door as `getQuote`/`getEarnings`. Use `searchSymbols` first and pass its exact `exchange` and `symbol` fields. Returns the most recently paid dividend (`amountRecent` per share, `exDateRecent`/`paymentDateRecent` in Unix seconds), the current trailing-twelve-month `yieldCurrent`, the TTM `payoutRatioTtm`, and `consecutiveYearsPaid` — how many years running the company has paid a dividend without a cut. A symbol that has never paid a dividend answers with every field undefined rather than an error; an unknown or delisted pair returns a caller-fixable error.\n\nCalls `bowmark.providers.tradingview.getDividends`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<Dividends>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"exchange":{"type":"string","description":"TypeScript: `string`"},"symbol":{"type":"string","description":"TypeScript: `string`"}},"required":["exchange","symbol"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/tradingview/getMarketOverview":{"post":{"operationId":"getMarketOverview","summary":"Gets an overview of major market indices — NASDAQ Composite, S&P 500, Russell 2000 and NASDAQ-100 — with their current prices, changes and OHLC data.","description":"Gets an overview of major market indices — NASDAQ Composite, S&P 500, Russell 2000 and NASDAQ-100 — with their current prices, changes and OHLC data. Returns each index' symbol, name, type, price, and change/changePercent against the previous close, along with open, high and low prices. Takes no arguments — it always returns the same set of major indices.\n\nCalls `bowmark.providers.tradingview.getMarketOverview`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<MarketOverview>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/tradingview/getScreenerResults":{"post":{"operationId":"getScreenerResults","summary":"Runs a stock screener against TradingView's own scanner door — the same query its screener widget runs — e.g.","description":"Runs a stock screener against TradingView's own scanner door — the same query its screener widget runs — e.g. `getScreenerResults({ columns: [\"name\", \"close\", \"market_cap_basic\"], filters: [{ field: \"sector\", operation: \"equal\", value: \"Technology Services\" }, { field: \"market_cap_basic\", operation: \"greater\", value: 1e12 }], sortBy: \"market_cap_basic\", sortOrder: \"desc\" })`. `columns` is any TradingView field name — the same ones `getQuote`/`getCompanyInfo`/`getFinancials` read, e.g. `close`, `market_cap_basic`, `sector`, `exchange`, `volume`, `price_earnings_ttm`. Each `filters` entry narrows on one field with an `operation` (`greater`/`egreater`/`less`/`eless`/`equal`/`nequal`/`in_range`/`not_in_range`/`match`) and a `value`. `market` selects which universe to scan — `america` (default), `global`, `crypto`, `forex`, `cfd`, or a country slug like `india`/`canada`/`uk`/`germany`. Returns `totalCount` (how many rows matched across the whole market, not just this page) and `rows`, each carrying `symbol`, `exchange` and a `fields` map keyed by the requested `columns`. An unrecognized `market` is a caller-fixable error; an unrecognized column or filter field is not — TradingView silently answers zero or empty rather than rejecting it, so a screener returning nothing is worth rechecking the field names against `getQuote`/`getCompanyInfo`.\n\nCalls `bowmark.providers.tradingview.getScreenerResults`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<ScreenerResults>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"options":{"type":"object","properties":{"columns":{"type":"array","items":{"type":"string"}},"market":{"type":"string"},"filters":{"type":"array","items":{"$ref":"#/components/schemas/ScreenerFilter"}},"sortBy":{"type":"string"},"sortOrder":{"anyOf":[{"const":"asc"},{"const":"desc"}]},"limit":{"type":"number"},"offset":{"type":"number"}},"required":["columns"],"additionalProperties":true,"description":"TypeScript: `{ columns: string[], market?: string, filters?: ScreenerFilter[], sortBy?: string, sortOrder?: \"asc\" | \"desc\", limit?: number, offset?: number }`"}},"required":["options"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/tradingview/getOptionChain":{"post":{"operationId":"getOptionChain","summary":"Gets the full listed option chain for one symbol — e.g.","description":"Gets the full listed option chain for one symbol — e.g. `getOptionChain(\"NASDAQ\", \"AAPL\")` — from TradingView's own options-scanner door, the same call its options-chain widget makes. Use `searchSymbols` first and pass its exact `exchange` and `symbol` fields. Returns every listed contract across every expiration: `expirations` (every distinct date, as `YYYYMMDD`, ascending) and `contracts`, each carrying its OCC-style `symbol`, `optionType` (`\"call\"`/`\"put\"`), `strike`, `expiration`, bid/ask and their implied vols, the Greeks (`delta`/`gamma`/`theta`/`vega`/`rho`), and `theoreticalPrice`. A symbol with no listed options (or an unknown pair) returns an empty chain (`expirations: []`, `contracts: []`) rather than an error.\n\nCalls `bowmark.providers.tradingview.getOptionChain`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<OptionChain>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"exchange":{"type":"string","description":"TypeScript: `string`"},"symbol":{"type":"string","description":"TypeScript: `string`"}},"required":["exchange","symbol"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/tradingview/getEconomicCalendar":{"post":{"operationId":"getEconomicCalendar","summary":"Gets upcoming (and recently released) economic events — e.g.","description":"Gets upcoming (and recently released) economic events — e.g. `getEconomicCalendar([\"US\"], 7)` for \"what US economic releases are due this week\" — the same feed TradingView's Markets › Economic calendar page renders. `countries` is an array of two-letter country codes, defaulting to `[\"US\"]`; `daysAhead` is the window forward from now, defaulting to 7, bounded 1-30. Returns events ascending by release date, each with the release `date` (Unix seconds), `title`, `indicator` name, reporting `period`, `actual`/`forecast`/`previous` values where TradingView carries them, and an `importance` score (-1/0/1 low/medium/high). An unrecognized country code answers zero matching rows rather than an error.\n\nCalls `bowmark.providers.tradingview.getEconomicCalendar`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<EconomicEvent[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"countries":{"type":"array","items":{"type":"string"},"description":"TypeScript: `string[]`"},"daysAhead":{"type":"number","description":"TypeScript: `number`"}},"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/tradingview/listIdeas":{"post":{"operationId":"listIdeas","summary":"Gets the public Ideas feed for one symbol — e.g.","description":"Gets the public Ideas feed for one symbol — e.g. `listIdeas(\"NASDAQ\", \"AAPL\")` for \"what are traders on TradingView saying about AAPL right now\" — the same feed the symbol's Ideas tab renders. Use `searchSymbols` first and pass its exact `exchange` and `symbol` fields. `sort` is one of `\"latest_popular\"`, `\"week_popular\"`, `\"trending\"`, `\"suggested\"`, `\"recent\"` (default), `\"recent_extended\"`, `\"picked_time\"` or `\"trending_one_idea_by_user_per_page\"` — TradingView's own enum, a bad value is a caller-fixable error. Returns up to 20 ideas per page (the first page only; TradingView itself paginates beyond that), each with the author's `title` and `description`, their `author` username, `createdAt`/`updatedAt` (Unix seconds), a `chartUrl` to the full idea, and `commentsCount`/`viewsCount`/`likesCount`. An unknown or delisted `exchange:symbol` pair returns a caller-fixable error.\n\nCalls `bowmark.providers.tradingview.listIdeas`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<Idea[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"exchange":{"type":"string","description":"TypeScript: `string`"},"symbol":{"type":"string","description":"TypeScript: `string`"},"sort":{"type":"string","description":"TypeScript: `string`"}},"required":["exchange","symbol"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}}},"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Your Bowmark API key."},"apiKeyHeader":{"type":"apiKey","in":"header","name":"X-Bowmark-Key"}},"responses":{"NotFound":{"description":"No such site or function.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}},"schemas":{"RunEnvelope":{"type":"object","description":"What a run returns. `status` says whether the SCRIPT succeeded. A script that threw or paused for a login is still HTTP 200. Branch on `status`, not on the HTTP code.","required":["ok","status","result","logs","error","ms"],"properties":{"runId":{"type":"string","description":"Stable id for this run. Quote it in a support or `report` message."},"ok":{"type":"boolean","description":"False only when the run produced nothing usable."},"status":{"type":"string","enum":["ok","error","partial","needs_user"],"description":"`partial`: the result is real but some calls failed (see `incomplete`); `ok` stays true. `needs_user`: a person must sign in to a site first. Relay `meta.handoff.url` to them, then run again."},"egress":{"type":"string","enum":["default","link"],"description":"The egress the run was given, present only when the request asked for one. `link`: every request went through the caller's own Chrome (Bowmark Buddy)."},"result":{"description":"Whatever the script `return`ed. Any JSON value."},"logs":{"type":"array","items":{"type":"string"},"description":"Lines the script wrote with `log(...)`."},"error":{"type":["string","null"],"description":"Why the run failed, in plain words. Null on success."},"ms":{"type":"integer","description":"How long the script itself ran, in milliseconds."},"queuedMs":{"type":"integer","description":"How long the run waited for a worker before starting. Present only when it was a second or more."},"needs":{"type":"array","description":"The sign-ins this script is waiting on. Present when `status` is `needs_user`.","items":{"type":"object","required":["capability","provider","providerTitle","kind"],"properties":{"capability":{"type":"string"},"provider":{"type":"string"},"providerTitle":{"type":"string","description":"The site's name, to show a person."},"kind":{"type":"string"}}}},"incomplete":{"type":"object","description":"Present only when `status` is `partial`: which calls did not answer.","properties":{"summary":{"type":"string"},"totalCalls":{"type":"integer"}},"additionalProperties":true},"emptyHanded":{"type":"object","description":"Present when the script returned nothing while its calls returned rows, usually a filter that matched none of the site's own labels. Lists the label values the calls actually returned.","additionalProperties":true},"notes":{"type":"array","description":"Caveats a call attached to a complete answer. Never changes `status`.","items":{"type":"object","properties":{"path":{"type":"string"},"notes":{"type":"array","items":{"type":"string"}}}}},"meta":{"type":"object","properties":{"handoff":{"type":"object","description":"A single-use sign-in link for a person to open. Expires at `expiresAt`.","properties":{"ref":{"type":"string"},"url":{"type":"string","format":"uri"},"expiresAt":{"type":"string","format":"date-time"}}},"concurrency":{"type":"object","description":"On a 429: how many runs are in flight and when to retry.","properties":{"limit":{"type":"integer"},"inFlight":{"type":"integer"},"retryAfterSeconds":{"type":"integer"}}}},"additionalProperties":true},"notice":{"type":"object","description":"Set when the account owner has not accepted the current Terms. Relay it to them.","additionalProperties":true}}},"ScreenerFilter":{"type":"object","properties":{"field":{"type":"string"},"operation":{"anyOf":[{"const":"greater"},{"const":"egreater"},{"const":"less"},{"const":"eless"},{"const":"equal"},{"const":"nequal"},{"const":"in_range"},{"const":"not_in_range"},{"const":"match"}]},"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}}]}},"required":["field","operation","value"],"additionalProperties":true}}}}