Get Market News

curl --request GET \
  --url https://data-tools.prd.arrays.org/api/v1/stocks/market-news \
  --header 'X-API-Key: <api-key>'

{
  "data": [
    {
      "authors": [
        "<string>"
      ],
      "banner_image": "<string>",
      "category_within_source": "<string>",
      "id": 123,
      "overall_sentiment_label": "<string>",
      "overall_sentiment_score": 123,
      "publish_time": 123,
      "source": "<string>",
      "source_domain": "<string>",
      "summary": "<string>",
      "tickers": [
        {
          "relevance_score": "<string>",
          "ticker": "<string>",
          "ticker_sentiment_label": "<string>",
          "ticker_sentiment_score": "<string>"
        }
      ],
      "time_published": "<string>",
      "title": "<string>",
      "topics": [
        {
          "relevance_score": "<string>",
          "topic": "<string>"
        }
      ],
      "url": "<string>"
    }
  ],
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "details": [
      {
        "field": "<string>",
        "got": "<string>",
        "reason": "<string>"
      }
    ],
    "docs_url": "<string>",
    "examples": [
      "<string>"
    ],
    "hint": "<string>",
    "message": "The requested resource was not found.",
    "suggestions": [
      "<string>"
    ]
  },
  "pagination": "<unknown>",
  "request_id": "<string>",
  "success": true
}

Stock

Get Market News

OpenAPI JSON Spec Retrieve market news articles within a specified time range, optionally filtered by symbol. Supports pagination and flexible filtering.

Use cases:

Market news aggregation and monitoring
Stock-specific news tracking
News analysis and sentiment tracking
Media applications and news feeds

Data & semantics:

start_time: Start time (Unix timestamp in seconds, required)
end_time: End time (Unix timestamp in seconds, required)
symbol: Stock symbol filter (optional, e.g., AAPL, TSLA)
topic: Topic filter (optional, lowercase). Valid values:
blockchain, earnings, economy_fiscal, economy_macro, economy_monetary
energy_transportation, finance, financial_markets, ipo, life_sciences
manufacturing, mergers_and_acquisitions, real_estate, retail_wholesale, technology
source: Media source filter (optional). Valid values:
Reuters, AP News, BBC, The New York Times, The Washington Post, The Guardian
Bloomberg, The Wall Street Journal, Financial Times, CNBC, Fortune
Forbes, TechCrunch, MIT Technology Review, The Verge
WIRED, South China Morning Post, Nikkei Asia, Business Wire, PR Newswire
sort_by_type: Sort by type - PUBLISHED_TIME, OVERALL_SENTIMENT_SCORE, or RELEVANCE_SCORE (optional, default: PUBLISHED_TIME)
sort_by: Sort order - “ASC” or “DESC” (optional, default: “DESC”)
limit: Maximum number of results (optional, default: 10, max: 100)
offset: Pagination offset (optional, default: 0, must be >= 0)

GET

/

v1

/

stocks

/

market-news

Get Market News

curl --request GET \
  --url https://data-tools.prd.arrays.org/api/v1/stocks/market-news \
  --header 'X-API-Key: <api-key>'

{
  "data": [
    {
      "authors": [
        "<string>"
      ],
      "banner_image": "<string>",
      "category_within_source": "<string>",
      "id": 123,
      "overall_sentiment_label": "<string>",
      "overall_sentiment_score": 123,
      "publish_time": 123,
      "source": "<string>",
      "source_domain": "<string>",
      "summary": "<string>",
      "tickers": [
        {
          "relevance_score": "<string>",
          "ticker": "<string>",
          "ticker_sentiment_label": "<string>",
          "ticker_sentiment_score": "<string>"
        }
      ],
      "time_published": "<string>",
      "title": "<string>",
      "topics": [
        {
          "relevance_score": "<string>",
          "topic": "<string>"
        }
      ],
      "url": "<string>"
    }
  ],
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "details": [
      {
        "field": "<string>",
        "got": "<string>",
        "reason": "<string>"
      }
    ],
    "docs_url": "<string>",
    "examples": [
      "<string>"
    ],
    "hint": "<string>",
    "message": "The requested resource was not found.",
    "suggestions": [
      "<string>"
    ]
  },
  "pagination": "<unknown>",
  "request_id": "<string>",
  "success": true
}

Authorizations

X-API-Key

string

header

required

API Key authentication. Example: "your-api-key-here"

Query Parameters

symbol

string

Stock symbol filter (optional)

topic

enum<string>

Topic filter (optional)

Available options:

blockchain,

earnings,

economy_fiscal,

economy_macro,

economy_monetary,

energy_transportation,

finance,

financial_markets,

ipo,

life_sciences,

manufacturing,

mergers_and_acquisitions,

real_estate,

retail_wholesale,

technology

source

string

Media source filter (optional, e.g. Reuters, Bloomberg, CNBC)

start_time

integer<int64>

required

Start time (Unix timestamp in seconds)

end_time

integer<int64>

required

End time (Unix timestamp in seconds)

sort_by_type

enum<string>

Sort by type: PUBLISHED_TIME, OVERALL_SENTIMENT_SCORE, or RELEVANCE_SCORE (default: PUBLISHED_TIME)

Available options:

PUBLISHED_TIME,

OVERALL_SENTIMENT_SCORE,

RELEVANCE_SCORE

sort_by

enum<string>

Sort order: ASC or DESC (default: DESC)

Available options:

ASC,

DESC

limit

integer

default:10

Maximum number of results (1-100, default: 10)

Required range: 1 <= x <= 100

offset

integer

default:0

Pagination offset (>=0, default: 0)

Required range: x >= 0

Response

List of market news articles

data

object[]

Show child attributes

error

object

Show child attributes

pagination

any

request_id

string

success

boolean

Get Market Metrics Time Series Data Get Mergers & Acquisitions Data