Overview

MarketAux delivers real-time financial news with sentiment analysis, ticker tagging, and market statistics in a clean JSON format. It is designed for developers building stock market dashboards, trading tools, or finance apps. The free tier allows limited daily requests and is a great way to explore financial news data without upfront costs.

Beginner Tip

Filter by a specific stock ticker using the symbols parameter (e.g., symbols=AAPL) to get highly relevant financial news instead of broad market coverage. The sentiment field (positive, negative, neutral) is pre-calculated, saving you from building your own text analysis.

Available Data

The kind of data this API exposes, based on its documentation. We could not call the endpoint to confirm the exact field names.

article title and content
publication source
published date
article URL
image URL
stock price and symbol

Example Response

Illustrative shape only — we were not able to call this endpoint (it requires credentials or exposes no public sample URL), so the fields below show the kind of data this API returns rather than a recorded response.

JSON Response · Illustrative
{
  "totalArticles": 100,
  "articles": [
    {
      "title": "Tech Industry Sees Record Growth",
      "source": {
        "name": "TechNews",
        "url": "https://technews.com"
      },
      "publishedAt": "2025-01-15T08:00:00Z",
      "description": "The technology sector reported unprecedented growth...",
      "image": "https://example.com/article-image.jpg",
      "url": "https://technews.com/article/123"
    }
  ]
}

Field Reference

data Array of financial news articles with metadata
data[].title Headline of the financial news article
data[].url Link to the full article on the original source
data[].published_at ISO 8601 timestamp of article publication
data[].entities Tagged stock tickers and companies mentioned in the article
data[].entities[].sentiment_score Sentiment score from -1 (negative) to +1 (positive) for the mentioned entity

Implementation Example

Calls a real endpoint of this API. Replace any placeholder credentials with your own key.

Request
const url = "https://api.marketaux.com/v1/news/all?symbols=AAPL&filter_entities=true&language=en&api_token=YOUR_API_KEY";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
  headers: {
  "X-API-Key": "YOUR_API_KEY"
  }
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

Generated guidance based on this API's documentation, not observed by us. Treat it as a starting point and check against the provider's own error reference.

401 Unauthorized api_token parameter is missing or invalid
Add your token as api_token=YOUR_API_KEY in the query string
No data returned for ticker The stock symbol is not tracked or news is unavailable right now
Try a major ticker like AAPL or TSLA first, then verify less common symbols in the MarketAux dashboard
429 Rate limit exceeded Free plan daily request limit has been reached
Cache results and reduce polling frequency; consider upgrading for higher limits

Metadata Score Breakdown

Estimated from metadata — endpoint not independently tested

This score is estimated from observable metadata — HTTPS support, authentication model, declared CORS, and documentation reachability — because the API requires authentication or exposes no publicly testable endpoint. The five-signal breakdown is only shown for live-tested APIs.

Metadata estimate · endpoint not independently tested

Technical Specifications

Auth API Key
HTTPS REQUIRED
CORS YES
Category News
Difficulty Intermediate
Listing details not endpoint-verified

Related Tags

Similar APIs

View All →