This headline-only article is meant to show you why a stock is moving, the most difficult aspect of stock trading....
' url: 'https://www.benzinga.com/news/21/12/24843171/apple-leader-in-phone-sales-in-china-for-second-straight-month-in-november-with-23-6-share-according' images: [] symbols: - AAPL source: benzinga next_page_token: MTY0MDk0ODkyMzAwMDAwMDAwMHwyNDg0MzE3MQ== schema: $ref: '#/components/schemas/GetNewsResponse' operationId: getNews description: Returns latest news articles across stocks and crypto. By default returns latest 10 news articles. tags: - News '/v1beta1/screener/{market_type}/movers': parameters: - schema: type: string enum: - stocks - crypto name: market_type in: path description: Screen specific market (stocks or crypto) required: true get: summary: Get Top Market Movers by Market type tags: - Screener responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MarketMoversResponse' examples: example-1: value: gainers: - symbol: AGRI percent_change: 145.56 change: 2.46 price: 4.15 - symbol: GRCYW percent_change: 85.63 change: 0.03 price: 0.0594 losers: - symbol: MTACW percent_change: -63.07 change: -0.26 price: 0.1502 - symbol: TIG percent_change: -51.21 change: -3.61 price: 3.435 market_type: stocks last_updated: '2022-03-10T17:53:30.088309839Z' operationId: getTopMoversByMarketType x-internal: true description: Returns top market movers for stocks. By default will return top 5 market gainers and losers. parameters: - schema: type: integer default: 10 maximum: 50 in: query name: top description: Number of top market movers to fetch (gainers and losers). Will return number top for each. By default 10 gainers and 10 losers. '/v1beta1/logos/{crypto_or_stock_symbol}': get: summary: Get Logo for symbol tags: - Logo responses: '200': description: Returns the requested logo as an image. content: image/*: schema: type: string format: binary description: the requested logo '404': description: No Logo was found for this symbol. This code will only be returned if you set `placeholder` to false. Otherwise we will generate a placeholder image for this symbol operationId: getLogoForSymbol description: Returns logo image resource for provided symbol. parameters: - schema: type: boolean default: true in: query name: placeholder description: If true then the api will generate a placeholder image if no logo was found. Defaults to true parameters: - schema: type: string name: crypto_or_stock_symbol in: path required: true description: 'The crypto or stock symbol to query for. Note, currently all crypto symbols must be appended with "USD", ie "BTCUSD" would be how you query for BTC.' /v2/stocks/meta/exchanges: get: summary: Get List of supported exchanges responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ExchangesResponse' examples: example-1: value: Z: Cboe BZ I: International Securities Exchange M: Chicago Stock Exchange U: Members Exchange L: Long Term Stock Exchange W: CBOE X: NASDAQ OMX PSX B: NASDAQ OMX BX D: FINRA ADF J: Cboe EDGA P: NYSE Arca Q: NASDAQ OMX S: NASDAQ Small Cap V: IEX A: NYSE American (AMEX) E: Market Independent 'N': New York Stock Exchange T: NASDAQ Int 'Y': Cboe BYX C: National Stock Exchange H: MIAX K: Cboe EDGX operationId: getExchanges description: Returns a json object representing the exchanges we support. The keys are the short form codes you will see in our responses and the values are their respective full names. tags: - Stock Pricing Data API '/v2/stocks/meta/conditions/{type}': parameters: - schema: type: string enum: - trade - quote example: trade name: type in: path required: true description: either "trade" or "quote" get: summary: Get list of Conditions responses: '200': description: |- OK Response is a JSON object mapping a condition to a plain text description content: application/json: schema: type: object additionalProperties: true examples: example-trading-A: value: '4': Derivatively Priced '5': Market Center Reopening Trade '6': Market Center Closing Trade '7': Qualified Contingent Trade '8': Reserved '9': Corrected Consolidated Close Price as per Listing Market F: Inter-market Sweep Order O: Market Center Opening Trade ' ': Regular Sale B: Average Price Trade C: Cash Trade (Same Day Clearing) E: Automatic Execution M: Market Center Official Close T: Extended Hours Trade U: Extended Hours Sold (Out Of Sequence) I: Odd Lot Trade K: Rule 127 (NYSE only) or Rule 155 (NYSE MKT only) R: Seller X: Cross Trade Z: Sold (Out Of Sequence) 'N': Next Day Trade (Next Day Clearing) P: Prior Reference Price Q: Market Center Official Open V: Contingent Trade H: Price Variation Trade L: Sold Last (Late Reporting) example-quote-C: value: '4': On Demand Intra Day Auction U: Manual Bid And Ask Non Firm B: Manual Bid Automated Ask R: Regular Two Sided Open A: Manual Ask Automated Bid F: Fast Trading H: Manual Bid And Ask L: Closed Quote 'N': Non Firm Quote I: Order Imbalance O: Opening Quote Automated 'Y': No Offer No Bid One Sided Open X: Order Influx Z: No Open No Resume operationId: getConditions description: |- Each feed/exchange uses its own set of codes to identify trade and quote conditions, so the same condition may have a different code depending on the originator of the data. See [Our documentation](https://alpaca.markets/docs/market-data/#conditions) for more information parameters: - schema: type: string enum: - A - B - C example: A in: query name: tape required: true description: 'What kind of conditions to retrieve, "A" and "B" return CTS, where "C" will give you UTP ' tags: - Stock Pricing Data API components: securitySchemes: API_Key: name: APCA-API-KEY-ID type: apiKey in: header API_Secret: name: APCA-API-SECRET-KEY type: apiKey in: header schemas: Trade: title: Trade type: object description: A model representing a trade x-examples: trade-example-1: t: '2021-02-06T13:04:56.334320128Z' x: C p: 387.62 s: 100 c: - ' ' - T i: 52983525029461 z: B example-crypto: t: '2022-02-27T11:04:55.82622Z' x: FTXU p: 39330 s: 0.0003 tks: B i: 25783365 properties: t: type: string description: Timestamp in RFC-3339 format with nanosecond precision format: date-time x: type: string description: Exchange where the trade happened. p: type: number description: Trade price. s: type: number description: Trade Size. c: type: array description: Trade conditions (Stock trade only) items: type: string i: type: integer description: Trade ID format: int64 z: type: string description: Tape (Stock trade only) tks: type: string description: Taker's side (crypto trade only) required: - x - i TradesResponse: title: TradesResponse type: object description: |- A model representing the result of hitting the Trades api. Represents multiple Trades for a single symbol with support for paging. x-examples: trades-example-1: trades: - t: '2021-02-06T13:04:56.334320128Z' x: C p: 387.62 s: 100 c: - ' ' - T i: 52983525029461 z: B - t: '2021-02-06T13:09:42.325484032Z' x: C p: 387.69 s: 100 c: - ' ' - T i: 52983525033813 z: B symbol: SPY next_page_token: MjAyMS0wMi0wNlQxMzowOTo0Mlo7MQ== properties: trades: type: array description: Array of trades items: $ref: '#/components/schemas/Trade' symbol: type: string description: Symbol that was queried example: AAPL minLength: 1 next_page_token: type: string description: Token that can be used to query the next page nullable: true required: - trades - symbol LatestTradeResponse: title: LatestTradeResponse type: object description: |- A model representing the result of hitting the Latest Trade api. Represents a single Trade that should be the latest trade data for a given ticker symbol x-examples: latestTradesResponse-example-1: symbol: AAPL trade: t: '2022-02-01T17:46:51.111055251Z' x: V p: 173.06 s: 100 c: - '@' i: 6519 z: C crypto-example-1: symbol: BTCUSD trade: t: '2022-03-08T22:27:26.573044Z' x: FTXU p: 38614 s: 0.0019 tks: S i: 26271424 properties: trade: $ref: '#/components/schemas/Trade' symbol: type: string description: Symbol that was queried example: AAPL minLength: 1 required: - symbol MultiTradesResponse: title: MultiTradesResponse type: object description: | A model representing the result of hitting the Multi Trades api; represents multiple trades for multiple symbols. Returned results are sorted by symbol first then by Trade timestamp. This means that you are likely to see only one symbol in your first response if there are enough Trades for that symbol to hit the limit you requested on that request. In these situations if you keep requesting again with the next_page_token you will eventually reach the next symbols if any Trades were found for them. x-examples: multiTradesResponse-example-1: trades: SPY: - t: '2021-02-06T13:04:56.334320128Z' x: C p: 387.62 s: 100 c: - ' ' - T i: 52983525029461 z: B - t: '2021-02-06T13:09:42.325484032Z' x: C p: 387.69 s: 100 c: - ' ' - T i: 52983525033813 z: B next_page_token: MjAyMS0wMi0wNlQxMzowOTo0Mlo7MQ== multiTradesResponse-with-multiple-symbols-at-once-example-1: trades: AAPL: - t: '2021-02-06T13:04:56.334320128Z' x: C p: 387.62 s: 100 c: - ' ' - T i: 52983525029461 z: B - t: '2021-02-06T13:09:42.325484032Z' x: C p: 387.69 s: 100 c: - ' ' - T i: 52983525033813 z: B SPY: - t: '2021-02-06T05:09:42.325484032Z' x: C p: 400.55 s: 100 c: - ' ' - T i: 52983525033954 z: B next_page_token: MjAyMS0wMi0wNlQxMzowOTo0Mlo7MQ== properties: trades: type: object additionalProperties: type: array items: $ref: '#/components/schemas/Trade' next_page_token: type: string nullable: true required: - trades LatestMultiTradesResponse: description: '' type: object x-examples: example-crypto-1: trades: ETHUSD: t: '2022-03-08T22:13:55.777631Z' x: FTXU p: 2562.8 s: 0.881 tks: S i: 26271234 BTCUSD: t: '2022-03-08T22:14:47.379901Z' x: FTXU p: 38510 s: 0.05 tks: B i: 26271277 example-1: trades: TSLA: t: '2022-03-11T17:24:55.143671726Z' x: V p: 801.83 s: 100 c: - '@' i: 9924 z: C AAPL: t: '2022-03-11T17:24:56.321817175Z' x: V p: 155.105 s: 300 c: - '@' i: 7741 z: C properties: trades: type: object additionalProperties: $ref: '#/components/schemas/Trade' required: - trades Snapshot: title: Snapshot type: object description: | The Snapshot API for one ticker provides the latest trade, latest quote, minute bar daily bar and previous daily bar data for a given ticker symbol. x-examples: snapshot-example-1: symbol: AAPL latestTrade: t: '2021-05-11T20:00:00.435997104Z' x: Q p: 125.91 s: 5589631 c: - '@' - M i: 179430 z: C latestQuote: t: '2021-05-11T22:05:02.307304704Z' ax: P ap: 125.68 as: 12 bx: P bp: 125.6 bs: 4 c: - R minuteBar: t: '2021-05-11T22:02:00Z' o: 125.66 h: 125.66 l: 125.66 c: 125.66 v: 396 dailyBar: t: '2021-05-11T04:00:00Z' o: 123.5 h: 126.27 l: 122.77 c: 125.91 v: 125863164 prevDailyBar: t: '2021-05-10T04:00:00Z' o: 129.41 h: 129.54 l: 126.81 c: 126.85 v: 79569305 properties: latestTrade: $ref: '#/components/schemas/Trade' latestQuote: $ref: '#/components/schemas/Quote' minuteBar: $ref: '#/components/schemas/Bar' dailyBar: $ref: '#/components/schemas/Bar' prevDailyBar: $ref: '#/components/schemas/Bar' MultiSnapshotResponse: title: MultiSnapshotResponse type: object description: | A model representing the result of hitting the Multi Snapshots api; represents Snapshots for multiple symbols. The result is an object whose keys are the requested symbols and values are their respecitve Snapshot additionalProperties: $ref: '#/components/schemas/Snapshot' x-examples: example-1: AAPL: latestTrade: t: '2022-03-11T19:08:43.947998695Z' x: V p: 156.055 s: 100 c: - '@' i: 10593 z: C latestQuote: t: '2022-03-11T19:09:06.125564144Z' ax: V ap: 157.2 as: 5 bx: V bp: 156.08 bs: 1 c: - R z: C minuteBar: t: '2022-03-11T19:08:00Z' o: 156.02 h: 156.1 l: 156.02 c: 156.055 v: 4483 'n': 26 vw: 156.055956 dailyBar: t: '2022-03-11T05:00:00Z' o: 158.94 h: 159.25 l: 154.76 c: 156.055 v: 1180799 'n': 10408 vw: 156.545239 prevDailyBar: t: '2022-03-10T05:00:00Z' o: 160.23 h: 160.38 l: 155.98 c: 158.52 v: 1889292 'n': 17072 vw: 157.845202 TSLA: latestTrade: t: '2022-03-11T19:08:59.479520429Z' x: V p: 796.95 s: 100 c: - '@' i: 13647 z: C latestQuote: t: '2022-03-11T19:09:06.159593323Z' ax: V ap: 850 as: 1 bx: V bp: 796.49 bs: 1 c: - R z: C minuteBar: t: '2022-03-11T19:08:00Z' o: 796.78 h: 797.4 l: 796.78 c: 796.95 v: 2139 'n': 46 vw: 797.116889 dailyBar: t: '2022-03-11T05:00:00Z' o: 840.38 h: 843.055 l: 795.33 c: 796.95 v: 466980 'n': 13232 vw: 811.369454 prevDailyBar: t: '2022-03-10T05:00:00Z' o: 851.5 h: 853.355 l: 810.76 c: 838.21 v: 578475 'n': 16118 vw: 828.766436 Quote: title: Quote type: object description: | The Quotes API provides NBBO quotes for a given ticker symbol at a specified date. x-examples: example-1: t: '2022-03-11T13:13:49.975594385Z' ax: V ap: 18696.3338 as: 1 bx: V bp: 0 bs: 0 c: - R z: C example-crypto: t: '2022-03-21T05:00:00.011543552Z' x: FTXU bp: 40761.35 bs: 0.465 ap: 41007.66 as: 2.8675 properties: t: type: string description: Timestamp in RFC-3339 format with nanosecond precision format: date-time ax: type: string description: ask exchange (Stock quote only) ap: type: number description: | ask price as: type: number description: | ask size bx: type: string description: bid exchange (Stock quote only) bp: type: number description: | bid price bs: description: bid size type: number c: type: array description: quote conditions (Stock quotes only) items: type: string x: type: string description: Exchange (Crypto quote Only) z: type: string description: Tape (Stock quote only) required: - t QuotesResponse: description: | The Quotes API provides NBBO quotes for a given ticker symbol at a specified date. type: object x-examples: quotesResponse-example-1: quotes: - t: '2022-02-01T09:00:00.000448Z' ax: K ap: 175 as: 1 bx: Q bp: 174.96 bs: 4 c: - R z: C - t: '2022-02-01T09:00:00.000448Z' ax: K ap: 175 as: 12 bx: Q bp: 174.96 bs: 4 c: - R z: C symbol: AAPL next_page_token: QUFQTHwyMDIyLTAyLTAxVDA5OjAwOjAwLjAwMDQ0ODAwMFp8MzFDODgxNkY= no-data-found-example: quotes: null symbol: AAPL next_page_token: null title: QuotesResponse properties: quotes: type: array uniqueItems: true minItems: 1 nullable: true items: $ref: '#/components/schemas/Quote' symbol: type: string minLength: 1 example: AAPL next_page_token: type: string minLength: 1 nullable: true required: - quotes - symbol LatestQuoteResponse: description: |- A model representing the result of hitting the Latest Quote api. Represents a single Quote that should be the latest quote data for a given ticker symbol type: object x-examples: quotesResponse-example-1: symbol: AAPL quote: t: '2022-02-01T17:51:03.204726425Z' ax: V ap: 173.24 as: 4 bx: V bp: 173.21 bs: 4 c: - R z: C title: LatestQuotesResponse properties: quote: $ref: '#/components/schemas/Quote' symbol: type: string minLength: 1 example: AAPL required: - quote - symbol MultiQuotesReponse: title: MultiQuotesReponse type: object description: | A model representing the result of hitting the Multi Quotes api; represents multiple Quotes for multiple symbols. Returned results are sorted by symbol first then by Quote timestamp. This means that you are likely to see only one symbol in your first response if there are enough Quotes for that symbol to hit the limit you requested on that request. In these situations if you keep requesting again with the next_page_token you will eventually reach the next symbols if any Quotes were found for them. x-examples: multiQuotesResponse-example-1: quotes: AAPL: - t: '2022-02-01T09:00:00.000448Z' ax: K ap: 175 as: 1 bx: Q bp: 174.96 bs: 4 c: - R z: C next_page_token: QUFQTHwyMDIyLTAyLTAxVDA5OjAwOjAwLjAwMDQ0ODAwMFp8MjIzMEUxOUM= multiTradesResponse-with-multiple-symbols-at-once-example-1: quotes: AAPL: - t: '2022-02-01T09:00:00.000448Z' ax: K ap: 175 as: 1 bx: Q bp: 174.96 bs: 4 c: - R z: C GOOGL: - t: '2022-02-01T09:00:00.000448Z' ax: K ap: 175 as: 1 bx: Q bp: 175 bs: 4 c: - R z: C next_page_token: QUFQTHwyMDIyLTAyLTAxVDA5OjAwOjAwLjAwMDQ0ODAwMFp8MjIzMEUxOUM= properties: quotes: type: object additionalProperties: type: array items: $ref: '#/components/schemas/Quote' next_page_token: type: string description: pass this token with your request again to get the next page of results nullable: true required: - quotes LatestMultiQuotesResponse: description: '' type: object x-examples: example-crypto: quotes: ETHUSD: t: '2022-03-08T22:40:52.536436224Z' x: FTXU bp: 2562.99 bs: 23.798 ap: 2579.11 as: 22.155 BTCUSD: t: '2022-03-08T22:40:52.662990848Z' x: FTXU bp: 38465.26 bs: 2.641 ap: 38698.75 as: 1.3746 example-1: quotes: AAPL: t: '2022-03-11T18:40:13.514830169Z' ax: V ap: 156.47 as: 3 bx: V bp: 156.45 bs: 1 c: - R z: C TSLA: t: '2022-03-11T18:40:12.416216587Z' ax: V ap: 850 as: 1 bx: V bp: 798 bs: 2 c: - R z: C properties: quotes: type: object additionalProperties: $ref: '#/components/schemas/Quote' required: - quotes Bar: title: Bar type: object description: | The bars API returns aggregate historical data for the requested securities. x-examples: stock-example-1: t: '2022-03-10T19:26:00Z' o: 158.035 h: 158.21 l: 158.035 c: 158.21 v: 800 'n': 15 vw: 158.113144 crypto-example-1: t: '2022-03-10T19:30:00Z' x: FTXU o: 39284 h: 39284 l: 39200 c: 39200 v: 1.1271 'n': 9 vw: 39233.9329252063 properties: t: type: string description: Timestamp in RFC-3339 format with nanosecond precision. format: date-time x: type: string description: Exchange. Only present on Bars for Crypto symbols enum: - FTXU - ERSX - CBSE o: type: number description: Open price h: type: number description: High price. l: type: number description: | Low price. c: type: number description: Close price. v: description: Volume. type: number 'n': type: integer description: Number of trades. format: int64 vw: description: Volume weighted average price. type: number required: - t - o - h - l - c - v BarsResponse: description: '' type: object x-examples: barsResponse-stock-example-1: bars: - t: '2021-02-01T16:01:00Z' o: 133.32 h: 133.74 l: 133.31 c: 133.5 v: 9876 - t: '2021-02-01T16:02:00Z' o: 133.5 h: 133.58 l: 133.44 c: 133.58 v: 3567 symbol: AAPL next_page_token: MjAyMS0wMi0wMVQxNDowMjowMFo7MQ== barsResponse-crypto-example-1: bars: - t: '2022-03-10T06:00:00Z' x: CBSE o: 39230.55 h: 40302.06 l: 38560.85 c: 39259.91 v: 11328.17046589 'n': 353132 vw: 39208.3129673941 - t: '2022-03-10T06:00:00Z' x: ERSX o: 39246.4 h: 40151 l: 38791 c: 39270 v: 153.254034 'n': 230 vw: 39255.8594375793 - t: '2022-03-10T06:00:00Z' x: FTXU o: 39170 h: 40290 l: 38560 c: 39200 v: 1511.2828 'n': 5248 vw: 39214.2388224758 symbol: BTCUSD next_page_token: null title: BarsResponse properties: bars: type: array uniqueItems: true minItems: 1 description: The array of Bar data items: $ref: '#/components/schemas/Bar' symbol: type: string minLength: 1 example: AAPL description: the stock ticker or crypto symbol this set of bar data is for next_page_token: type: string minLength: 1 nullable: true required: - bars - symbol - next_page_token LatestBarResponse: description: |- A model representing the result of hitting one of the Latest Bar api endpoints. Represents a single Bar that should be the latest Bar data for a given ticker symbol type: object x-examples: crypto-example-1: symbol: BTCUSD bar: t: '2022-03-08T21:05:00Z' x: FTXU o: 38576 h: 38576 l: 38576 c: 38576 v: 0.063 'n': 1 vw: 38576 stock-example-1: symbol: AAPL bar: t: '2022-03-10T19:26:00Z' o: 158.035 h: 158.21 l: 158.035 c: 158.21 v: 800 'n': 15 vw: 158.113144 properties: symbol: type: string minLength: 1 bar: $ref: '#/components/schemas/Bar' required: - symbol - bar MultiBarsResponse: description: | A model representing the result of hitting the Multi Bars api; represents multiple Bars for multiple symbols. Returned results are sorted by symbol first then by Bar timestamp. This means that you are likely to see only one symbol in your first response if there are enough Bars in the duration you specified for that symbol to hit the limit you requested on that request. In these situations if you keep requesting again with the next_page_token you will eventually reach the next symbols if any Bars were found for them in the timeframe. type: object x-examples: multiBarsResponse-with-multiple-symbols-at-once-example-1: bars: AAPL: - t: '2022-02-01T09:04:00Z' o: 175.14 h: 175.16 l: 175.12 c: 175.16 v: 1395 'n': 61 vw: 175.174624 - t: '2022-02-01T09:05:00Z' o: 175.21 h: 175.21 l: 175.1 c: 175.13 v: 1821 'n': 61 vw: 175.143635 TSLA: - t: '2022-02-01T09:05:00Z' o: 944.99 h: 944.99 l: 944.99 c: 944.99 v: 2520 'n': 207 vw: 944.437393 next_page_token: null multiBarsResponse-with-page-token-example-1: bars: BTCUSD: - t: '2022-02-28T06:00:00Z' x: FTXU o: 37866 h: 44340 l: 37494 c: 43241 v: 2817.008 'n': 10116 vw: 40876.4518611946 next_page_token: QlRDVVNEfER8MjAyMi0wMi0yOFQwNjowMDowMC4wMDAwMDAwMDBafEZUWFU= title: MultiBarsResponse properties: bars: type: object additionalProperties: type: array items: $ref: '#/components/schemas/Bar' next_page_token: type: string nullable: true required: - bars LatestMultiBarsResponse: title: LatestMultiBarsResponse type: object x-examples: example-1: bars: LINKUSD: t: '2022-03-08T17:33:00Z' x: FTXU o: 13.3565 h: 13.3565 l: 13.3565 c: 13.3565 v: 41.4 'n': 1 vw: 13.3565 BTCUSD: t: '2022-03-08T17:40:00Z' x: FTXU o: 39055 h: 39055 l: 39055 c: 39055 v: 0.1 'n': 1 vw: 39055 description: | A model representing the result of hitting the Latest Multi Bars api; represents the latest Bars for multiple symbols. properties: bars: type: object additionalProperties: $ref: '#/components/schemas/Bar' required: - bars News: description: Model representing a news article from the Alpaca Market Data API type: object x-examples: news-example-1: id: 24803233 headline: Benzinga's Top 5 Articles For 2021 — Or 'Who Let The Dog Out?' author: Sue Strachan created_at: '2021-12-29T15:11:03Z' updated_at: '2021-12-30T20:37:41Z' summary: '2021 may have been the Year of the Ox in the Chinese calendar, but for Benzinga, it was the Year of the Dog, or should we say, Year of the Dogecoin (CRYPTO: DOGE).' content: "2021 may have been the Year of the Ox in the Chinese calendar, but for Benzinga, it was the Year of the Dog, or should we say, Year of the Dogecoin (CRYPTO: DOGE).
\r\n\r\nThe memecoin created in 2013...." url: 'https://www.benzinga.com/news/21/12/24843171/apple-leader-in-phone-sales-in-china-for-second-straight-month-in-november-with-23-6-share-according' images: - size: large url: 'https://cdn.benzinga.com/files/imagecache/2048x1536xUP/images/story/2012/doge_12.jpg' - size: small url: 'https://cdn.benzinga.com/files/imagecache/1024x768xUP/images/story/2012/doge_12.jpg' - size: thumb url: 'https://cdn.benzinga.com/files/imagecache/250x187xUP/images/story/2012/doge_12.jpg' symbols: - AMZN - BTCUSD - COIN - DOGEUSD - SPCE - TSLA - TWTR source: benzinga properties: id: type: integer format: int64 description: News article ID headline: type: string minLength: 1 description: Headline or title of the article author: type: string minLength: 1 description: Original author of news article created_at: type: string format: date-time description: Date article was created (RFC 3339) updated_at: type: string format: date-time description: Date article was updated (RFC 3339) summary: type: string minLength: 1 description: Summary text for the article (may be first sentence of content) content: type: string minLength: 1 description: Content of the news article (might contain HTML) url: type: string format: uri description: URL of article (if applicable) nullable: true images: type: array uniqueItems: true description: List of images (URLs) related to given article (may be empty) items: $ref: '#/components/schemas/NewsImage' symbols: type: array description: List of related or mentioned symbols items: type: string source: type: string minLength: 1 description: Source where the news originated from (e.g. Benzinga) required: - id - headline - author - created_at - updated_at - summary - content - images - symbols - source NewsImage: description: A model representing images for news article. simply a url to the image along with a size parameter suggesting the display size of the image type: object x-examples: newsimage-example-1: size: thumb url: 'https://cdn.benzinga.com/files/imagecache/250x187xUP/images/story/2012/doge_12.jpg' title: NewsImage properties: size: type: string minLength: 1 description: 'Possible values for size are thumb, small and large.' example: thumb enum: - thumb - small - large readOnly: true url: type: string minLength: 1 description: url to image from news article format: uri readOnly: true required: - size - url GetNewsResponse: title: GetNewsResponse type: object properties: news: type: array items: $ref: '#/components/schemas/News' next_page_token: type: string description: Pagination token for next page XBBO: description: XBBO or Cross Best Bid and Offer represents the Best Bid and Offer for an exchange type: object x-examples: example-1: t: '2022-02-01T20:21:03.323000342Z' ax: FTXU ap: 38529 as: 0.0688 bx: ERSX bp: 38534 bs: 1.5 properties: t: type: string format: date-time description: Timestamp in RFC-3339 format with nanosecond precision. ax: type: string minLength: 1 description: Ask exchange. ap: type: number description: Ask price. as: type: number description: Ask size. bx: type: string minLength: 1 description: Bid exchange. bp: type: number description: Bid price. bs: type: number description: Bid size. required: - t - ax - ap - as - bx - bp - bs title: XBBO LatestXBBOResponse: description: Represents the Latest XBBO for a crypto symbol that calculates the Best Bid and Offer across multiple exchanges. type: object x-examples: example-1: symbol: BTCUSD xbbo: t: '2022-02-01T20:21:03.323000342Z' ax: FTXU ap: 38529 as: 0.0688 bx: ERSX bp: 38534 bs: 1.5 properties: symbol: type: string minLength: 1 xbbo: $ref: '#/components/schemas/XBBO' required: - symbol - xbbo title: LatestXBBOResponse LatestMultiXBBOResponse: description: '' type: object x-examples: example-1: xbbos: BTCUSD: t: '2022-03-08T22:59:49.514811056Z' ax: ERSX ap: 38556.7 as: 1.556151 bx: FTXU bp: 38562 bs: 2.5781 properties: xbbos: type: object additionalProperties: $ref: '#/components/schemas/XBBO' required: - xbbos CryptoSpreadsResponse: description: '' type: object x-examples: example-1: spreads: ERSX: 30 FTXU: 30 properties: spreads: type: object additionalProperties: type: integer required: - spreads MarketMoversResponse: title: MarketMovers type: object description: 'Contains list of market movers ' x-internal: true x-examples: example-1: gainers: - symbol: AAPL percent_change: 10 change: 0.1 price: 150.23 losers: - symbol: TSLA percent_change: 15 change: 0.15 price: 220.24 market_type: stocks last_updated: '2022-01-14T20:46:00.392227' properties: gainers: type: array description: List of top N gainers items: $ref: '#/components/schemas/MarketMoverAsset' losers: description: List of top N losers type: array items: $ref: '#/components/schemas/MarketMoverAsset' market_type: type: string enum: - stocks - crypto description: Market type (stocks or crypto) last_updated: type: string description: Time the movers where last computed required: - gainers - losers - market_type - last_updated MarketMoverAsset: title: MarketMoverAsset type: object description: Name or source of given news article x-examples: example-1: symbol: AGRI percent_change: 145.56 change: 2.46 price: 4.15 x-internal: true properties: symbol: type: string description: Symbol of market moving asset percent_change: type: number description: Percentage difference change for the day change: type: number description: Difference in change for the day price: type: number description: Current price of market moving asset required: - symbol - percent_change - change - price ExchangesResponse: title: ExchangesResponse type: object additionalProperties: type: string x-examples: example-1: Z: Cboe BZ I: International Securities Exchange M: Chicago Stock Exchange U: Members Exchange L: Long Term Stock Exchange W: CBOE X: NASDAQ OMX PSX B: NASDAQ OMX BX D: FINRA ADF J: Cboe EDGA P: NYSE Arca Q: NASDAQ OMX S: NASDAQ Small Cap V: IEX A: NYSE American (AMEX) E: Market Independent 'N': New York Stock Exchange T: NASDAQ Int 'Y': Cboe BYX C: National Stock Exchange H: MIAX K: Cboe EDGX description: Returns an object representing the exchanges we support. The keys are the short form codes you will see in our responses and the values are their respective full names. parameters: crypto-exchanges: name: exchanges in: query required: false schema: type: string example: 'ERSX,CBSE' description: 'A comma separated list of which crypto exchanges to pull the data from. Alpaca currently supports `ERSX`, `CBSE`, and `FTXU`' crypto-exchange: name: exchange in: query required: true schema: type: string enum: - ERSX - CBSE - FTXU example: ERSX description: 'Which crypto exchange to pull the data from. Alpaca currently supports `ERSX`, `CBSE`, and `FTXU`' crypto-symbols: name: symbols in: query required: true schema: type: string example: 'BTCUSD,ETHUSD' description: 'The comma-separated list of crypto symbols to query for. Note, currently all crypto symbols must be appended with "USD", ie "BTCUSD,ETHUSD" would get both BTC and ETH' crypto-symbol: name: symbol in: path required: true schema: type: string example: BTCUSD description: 'The crypto symbol to query for. Note, currently all crypto symbols must be appended with "USD", ie "BTCUSD" would be how you query for BTC.' timeframe: name: timeframe in: query required: true schema: type: string description: 'Timeframe for the aggregation. Values are customizeable, frequently used examples: 1Min, 15Min, 1Hour, 1Day. Limits: 1Min-59Min, 1Hour-23Hour.' page_token: name: page_token in: query required: false schema: type: string description: Pagination token to continue from. The value to pass here is returned in specific requests when more data is available than the request limit allows. start: name: start in: query required: false schema: type: string format: date-time example: '2021-01-01T00:00:00Z' description: Filter data equal to or after this time in RFC-3339 format. Fractions of a second are not accepted. end: name: end in: query required: false schema: type: string format: date-time example: '2021-01-01T00:00:00Z' description: Filter data equal to or before this time in RFC-3339 format. Fractions of a second are not accepted. limit: name: limit in: query required: false schema: type: integer minimum: 1 maximum: 10000 description: 'Number of data points to return. Must be in range 1-10000, defaults to 1000.' stock-symbol: name: symbol in: path required: true schema: type: string example: AAPL description: The stock ticker symbol to query for. feed: name: feed in: query required: false schema: type: string enum: - iex - sip - otc example: sip description: 'Which feed to pull market data from. This is either `iex`, `otc`, or `sip`. `sip` and `otc` are only available to those with a subscription' adjustment: name: adjustment in: query required: false schema: type: string enum: - raw - split - dividend - all description: specifies the corporate action adjustment(s) for bars data stock-symbols: name: symbols in: query required: true schema: type: string example: 'AAPL,TSLA' description: The comma-separated list of stock ticker symbols to query for. security: - API_Key: [] API_Secret: []