# MarketAux

> Global financial and stock market news API with entity recognition and sentiment analysis. Covers 5,000+ news sources in 30+ languages, tracking 200,000+ entities (equities, indices, ETFs, mutual funds, currencies, cryptocurrencies) across 80+ markets. Free tier available; authenticate with the api_token query parameter.

Marketaux publishes no llms.txt of its own (probed 2026-07-22, 404); this file was generated by API Evangelist from the provider's documentation and the artifacts in this repository.

Base URL: https://api.marketaux.com/v1
Authentication: api_token query parameter (free signup at https://www.marketaux.com/register)
Rate limits: 60-second rolling limit (X-RateLimit-Limit header, 429) plus a plan-based daily quota (X-UsageLimit-Limit header, 402).

## APIs

- [Finance & market news](https://www.marketaux.com/documentation#finance-news): GET /v1/news/all — latest global financial news with per-entity sentiment and match scores; filter by symbols, entity types, industries, countries, sentiment, full-text search, sources, language, and publish dates.
- [Similar news](https://www.marketaux.com/documentation#similar-news): GET /v1/news/similar/{uuid} — stories similar to a given article.
- [News by UUID](https://www.marketaux.com/documentation#news-by-uuid): GET /v1/news/uuid/{uuid} — retrieve a stored article.
- [Entity stats time series](https://www.marketaux.com/documentation#entity-stats): GET /v1/entity/stats/intraday — document counts and average sentiment per entity by minute/hour/day/week/month/quarter/year (Standard plan+).
- [Entity stats aggregation](https://www.marketaux.com/documentation#entity-aggregation): GET /v1/entity/stats/aggregation — single-time-frame aggregation (Standard plan+).
- [Trending entities](https://www.marketaux.com/documentation#trending-aggregation): GET /v1/entity/trending/aggregation — trending entities with scores (Standard plan+).
- [Entity search](https://www.marketaux.com/documentation#entity-search): GET /v1/entity/search — search all supported entities.
- [Entity types](https://www.marketaux.com/documentation#entity-types): GET /v1/entity/type/list
- [Entity industries](https://www.marketaux.com/documentation#entity-industries): GET /v1/entity/industry/list
- [News sources](https://www.marketaux.com/documentation#sources): GET /v1/news/sources — sources usable in domains/source_ids filters.

## Specs

- [OpenAPI (generated from docs)](https://raw.githubusercontent.com/api-evangelist/marketaux/refs/heads/main/openapi/marketaux-openapi.yml)
- [Error catalog](https://raw.githubusercontent.com/api-evangelist/marketaux/refs/heads/main/errors/marketaux-problem-types.yml)
- [Conventions profile](https://raw.githubusercontent.com/api-evangelist/marketaux/refs/heads/main/conventions/marketaux-conventions.yml)
- [Plans](https://raw.githubusercontent.com/api-evangelist/marketaux/refs/heads/main/plans/marketaux-plans.yml)
- [Rate limits](https://raw.githubusercontent.com/api-evangelist/marketaux/refs/heads/main/rate-limits/marketaux-rate-limits.yml)

## Docs

- [API documentation](https://www.marketaux.com/documentation)
- [Pricing](https://www.marketaux.com/pricing)
- [Sign up](https://www.marketaux.com/register)
- [FAQ](https://www.marketaux.com/faq)
- [Contact / support](https://www.marketaux.com/contact)
- [Terms of service](https://www.marketaux.com/tos)
- [Privacy policy](https://www.marketaux.com/privacy)