Skip to main content
GET
/
v1
/
news
Get Market News
curl --request GET \
  --url https://api.aries.com/v1/news \
  --header 'Authorization: Bearer <token>'
{
  "news": [
    {
      "action": "",
      "authors": [
        "Jane Smith"
      ],
      "id": 123456,
      "symbols": [
        "AAPL"
      ],
      "title": "Apple Announces New Product Line",
      "body": "",
      "news_type": "news",
      "timestamp": "2024-02-16T14:30:00Z"
    },
    {
      "action": "",
      "authors": [
        "John Doe"
      ],
      "id": 123457,
      "symbols": [
        "MSFT"
      ],
      "title": "Microsoft Q4 Earnings Beat Expectations",
      "body": "",
      "news_type": "press_release",
      "timestamp": "2024-02-16T13:15:00Z"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

OAuth2 Bearer token: obtain an access token from the token endpoint and send it in the Authorization header.

Query Parameters

​
symbols
string
default:SPY

Comma-separated list of stock symbols to filter news by. Default is SPY when omitted. Maximum 10 symbols per request. Each symbol must be a plain uppercase ticker (e.g. AAPL,TSLA,NVDA).

Example:

"AAPL,GOOGL,MSFT"

​
topics
string

Comma-separated list of topics to filter news. Maximum 10 topics per request. Common topics:

  • earnings — earnings releases and reports.
  • guidance — forward guidance updates.
  • mergers_acquisitions — M&A activity.
  • dividends — dividend announcements.
  • analyst_ratings — analyst upgrades and downgrades.
  • ipo — initial public offerings.
  • regulatory — SEC filings, lawsuits, regulatory actions.

Topic names depend on the upstream news catalog and may evolve over time.

Example:

"earnings,guidance"

Response

News retrieved successfully

​
news
object[]

Array of news items and press releases, sorted by timestamp (newest first)