News articles

get

https://data.alpaca.markets/v1beta1/news

Returns the latest news articles across stocks and crypto. By default, returns the latest 10 news articles.

Query Params

start

date-time

The inclusive start of the interval. Format: RFC-3339 or YYYY-MM-DD. Default: the beginning of the current day, but at least 15 minutes ago if the user doesn't have real-time access for the feed.

end

date-time

The inclusive end of the interval. Format: RFC-3339 or YYYY-MM-DD. Default: the current time if the user has a real-time access for the feed, otherwise 15 minutes before the current time.

sort

string

enum

Defaults to desc

Sort articles by updated date.

Allowed:

symbols

string

A comma-separated list of symbols for which to query news.

limit

integer

1 to 50

Limit of news items to be returned for a result page.

include_content

boolean

Boolean indicator to include content for news articles (if available).

exclude_contentless

boolean

Boolean indicator to exclude news articles that do not contain content.

page_token

string

The pagination token from which to continue. The value to pass here is returned in specific requests when more data is available, usually because of a response result limit.

Responses

401

Authentication headers are missing or invalid. Make sure you authenticate your request with a valid API key.

403

The requested resource is forbidden.

500

Internal server error. We recommend retrying these later. If the issue persists, please contact us on Slack or on the Community Forum.

200OK

400One of the request parameters is invalid. See the returned message for details.

429Too many requests. You hit the rate limit. Use the X-RateLimit-... response headers to make sure you're under the rate limit.