MarketAux

https://www.marketaux.com/documentation
Admin
MarketAux is a financial news API that provides global stock market news and analysis with entity...
Tokens:14,984
Snippets:81
Trust Score:7.7
Update:2 months ago
Show doc for...
Tokens:
Raw
### Request Intraday Entity Statistics

Source: https://www.marketaux.com/documentation

Example GET request to retrieve intraday statistics for specific symbols with filtering parameters.

```http
GET https://api.marketaux.com/v1/entity/stats/intraday?symbols=TSLA,AMZN,MSFT&interval=day&published_after=2026-07-25T09:48&language=en&api_token=YOUR_API_TOKEN
```

--------------------------------

### Example News by UUID Request

Source: https://www.marketaux.com/documentation

A sample request demonstrating the inclusion of the required api_token parameter.

```HTTP
GET https://api.marketaux.com/v1/news/uuid/147013d8-6c2c-4d50-8bad-eb3c8b7f5740?api_token=YOUR_API_TOKEN
```

--------------------------------

### GET Trending Entity Aggregation Request

Source: https://www.marketaux.com/documentation

Example request to the trending entity aggregation endpoint with query parameters for countries, document count, date, and language.

```http
GET https://api.marketaux.com/v1/entity/trending/aggregation?countries=us,ca&min_doc_count=10&published_after=2026-07-25T09:48&language=en&api_token=YOUR_API_TOKEN
```

--------------------------------

### Entity Search Response Example

Source: https://www.marketaux.com/documentation

A sample JSON response returned by the entity search endpoint.

```json
{
    "meta": {
        "found": 1,
        "returned": 1,
        "limit": 50,
        "page": 1
    },
    "data": [
        {
            "symbol": "TSLA",
            "name": "Tesla, Inc.",
            "type": "equity",
            "industry": "Consumer Cyclical",
            "exchange": null,
            "exchange_long": null,
            "country": "us"
        }
    ]
}
```

--------------------------------

### GET /entities

Source: https://www.marketaux.com/documentation

Retrieve entity data with various filtering and sorting options.

```APIDOC
## GET /entities

### Description
Retrieve identified entities from articles based on specified filters, sentiment scores, and date ranges.

### Method
GET

### Endpoint
/entities

### Parameters
#### Query Parameters
- **api_token** (string) - Required - Your API token found on your account dashboard.
- **group_by** (string) - Optional - Group results by symbol, exchange, industry, or country. Default: symbol.
- **min_doc_count** (integer) - Optional - Minimum number of total_documents an entity should be identified within.
- **symbols** (string) - Optional - Comma separated entity symbols.
- **entity_types** (string) - Optional - Comma separated entity types.
- **industries** (string) - Optional - Comma separated industries.
- **countries** (string) - Optional - Comma separated countries.
- **sentiment_avg_gte** (float) - Optional - Filter entities with average sentiment >= x.
- **sentiment_avg_lte** (float) - Optional - Filter entities with average sentiment <= x.
- **sentiment_gte** (float) - Optional - Filter documents with sentiment score >= x.
- **sentiment_lte** (float) - Optional - Filter documents with sentiment score <= x.
- **search** (string) - Optional - Search query string supporting AND, OR, negation, phrases, and prefix queries.
- **domains** (string) - Optional - Comma separated list of domains to include.
- **exclude_domains** (string) - Optional - Comma separated list of domains to exclude.
- **source_ids** (string) - Optional - Comma separated list of source_ids to include.
- **exclude_source_ids** (string) - Optional - Comma separated list of source_ids to exclude.
- **language** (string) - Optional - Comma separated list of languages to include.
- **published_before** (string) - Optional - Filter articles published before the specified date.
- **published_after** (string) - Optional - Filter articles published after the specified date.
- **published_on** (string) - Optional - Filter articles published on the specified date.
- **sort** (string) - Optional - Sort by total_documents or sentiment_avg. Default: total_documents.
- **sort_order** (string) - Optional - Sort order: desc or asc. Default: desc.
- **limit** (integer) - Optional - Number of entities to return.
```

--------------------------------

### Fetch news data with Go

Source: https://www.marketaux.com/documentation

Uses the standard net/http library. The example demonstrates building a URL with query parameters.

```go
package main

import (
    "fmt"
    "io/ioutil"
    "net/http"
    "net/url"
)

func main() {
    baseURL, _ := url.Parse("https://marketaux.com")

    baseURL.Path += "v1/news/all"

    params := url.Values{}
    params.Add("api_token", "YOUR_API_TOKEN")
    params.Add("symbols", "aapl,tsla")
    params.Add("search", "ipo")
    params.Add("limit", "50")

    baseURL.RawQuery = params.Encode()

    req, _ := http.NewRequest("GET", baseURL.String(), nil)

    res, _ := http.DefaultClient.Do(req)

    defer res.Body.Close()

    body, _ := ioutil.ReadAll(res.Body)

    fmt.Println(string(body))
}
```

--------------------------------

### Marketaux News API Request

Source: https://www.marketaux.com/documentation

Example GET request to retrieve news articles for specific symbols with entity filtering enabled.

```http
GET https://api.marketaux.com/v1/news/all?symbols=TSLA,AMZN,MSFT&filter_entities=true&language=en&api_token=YOUR_API_TOKEN
```

--------------------------------

### Example News Sources Response

Source: https://www.marketaux.com/documentation

A sample JSON response containing metadata and a list of available news sources.

```json
{
    "meta": {
        "found": 5327,
        "returned": 50,
        "limit": 50,
        "page": 1
    },
    "data": [
        {
            "source_id": "adweek.com-1",
            "domain": "adweek.com",
            "language": "en"
        },
        {
            "source_id": "adage.com-1",
            "domain": "adage.com",
            "language": "en"
        },
        {
            "source_id": "avc.com-1",
            "domain": "avc.com",
            "language": "en"
        },
        ...
    ]
}
```

--------------------------------

### Entity Search Request Example

Source: https://www.marketaux.com/documentation

A sample request demonstrating how to search for a specific entity by name and country filter.

```http
GET https://api.marketaux.com/v1/entity/search?search=tsla&countries=us&api_token=YOUR_API_TOKEN
```

--------------------------------

### Example Error Response

Source: https://www.marketaux.com/documentation

The standard JSON structure returned when an API request fails.

```json
{
    "error": {
        "code": "malformed_parameters",
        "message": "The published_before parameter(s) are incorrectly formatted."
    }
}
```

--------------------------------

### GET /articles (Search Parameters)

Source: https://www.marketaux.com/documentation

Parameters used to refine search queries for articles.

```APIDOC
## GET /articles

### Description
Search the full body and title of articles using various filtering and sorting parameters.

### Method
GET

### Parameters
#### Query Parameters
- **domains** (string) - Optional - Comma separated list of domains to include.
- **exclude_domains** (string) - Optional - Comma separated list of domains to exclude.
- **source_ids** (string) - Optional - Comma separated list of source_ids to include.
- **exclude_source_ids** (string) - Optional - Comma separated list of source_ids to exclude.
- **language** (string) - Optional - Comma separated list of languages to include.
- **published_before** (string) - Optional - Find all articles published before the specified date.
- **published_after** (string) - Optional - Find all articles published after the specified date.
- **published_on** (string) - Optional - Find all articles published on the specified date.
- **sort** (string) - Optional - Sort by published_on, entity_match_score, entity_sentiment_score or relevance_score.
- **sort_order** (string) - Optional - Sort order (desc or asc). Only used with entity_match_score or entity_sentiment_score.
- **limit** (integer) - Optional - Specify the number of articles to return.
- **page** (integer) - Optional - Use this to paginate through the result set.
```

--------------------------------

### Example News Sources Request

Source: https://www.marketaux.com/documentation

A sample request to retrieve English language news sources using an API token.

```http
GET https://api.marketaux.com/v1/news/sources?api_token=YOUR_API_TOKEN&language=en
```

--------------------------------

### GET https://api.marketaux.com/v1/entity/type/list

Source: https://www.marketaux.com/documentation

Retrieves a list of all supported entity types.

```APIDOC
## GET https://api.marketaux.com/v1/entity/type/list

### Description
Use this endpoint to return all supported entity types.

### Method
GET

### Endpoint
https://api.marketaux.com/v1/entity/type/list

### Parameters
#### Query Parameters
- **api_token** (string) - Required - Your API token which can be found on your account dashboard.

### Request Example
GET https://api.marketaux.com/v1/entity/type/list?api_token=YOUR_API_TOKEN

### Response
#### Success Response (200)
- **data** (array) - Array of entity types.

#### Response Example
{
    "data": [
        "equity",
        "index",
        "etf",
        "mutualfund",
        "currency",
        "cryptocurrency"
    ]
}
```

--------------------------------

### Fetch news data with C#

Source: https://www.marketaux.com/documentation

Uses the RestSharp library. Ensure the RestSharp NuGet package is installed.

```csharp
var client = new RestClient("https://api.marketaux.com/v1/news/all");
client.Timeout = -1;

var request = new RestRequest(Method.GET);

request.AddQueryParameter("api_token", "YOUR_API_TOKEN");
request.AddQueryParameter("symbols", "aapl,amzn");
request.AddQueryParameter("limit", "50");

IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);
```

--------------------------------

### GET /v1/news/similar/{uuid}

Source: https://www.marketaux.com/documentation

Retrieves a list of news articles that are similar to the article specified by the UUID.

```APIDOC
## GET /v1/news/similar/{uuid}

### Description
Retrieves a list of news articles that are similar to the article specified by the UUID.

### Method
GET

### Endpoint
https://api.marketaux.com/v1/news/similar/{uuid}

### Parameters
#### Path Parameters
- **uuid** (string) - Required - The unique identifier for the article.

#### Query Parameters
- **api_token** (string) - Required - Your API authentication token.
- **language** (string) - Optional - Filter results by language.
- **published_on** (string) - Optional - Filter results by publication date (YYYY-MM-DD).

### Response
#### Success Response (200)
- **meta** (object) - Metadata about the result set (found, returned, limit, page).
- **data** (array) - List of similar news articles.

#### Response Example
{
    "meta": {
        "found": 222,
        "returned": 3,
        "limit": 3,
        "page": 1
    },
    "data": [
        {
            "uuid": "489e4ec4-84a9-4628-966c-95c3741c6dfc",
            "title": "Bitcoin Drops below $47K: Is BTC in a Bear Market?",
            "description": "Bitcoin's rally seems to have made a sharp U-turn. Is this a short-lived correction or a longer-term trend?",
            "url": "https://www.financemagnates.com/cryptocurrency/news/bitcoin-drops-below-47k-is-btc-in-a-bear-market/",
            "published_at": "2021-02-23T11:00:40.000000Z"
        }
    ]
}
```

--------------------------------

### Example News by UUID Response

Source: https://www.marketaux.com/documentation

A sample JSON response containing article metadata, source information, and entity analysis.

```JSON
{
    "uuid": "9b9fb67e-9438-4263-815e-ef6a7d36af07",
    "title": "Bitcoin (BTC/USD), Ethereum (ETH/USD) Crushed as Cryptocurrency Market is Overrun by Sellers",
    "description": "The cryptocurrency market has been experiencing wild price swings over the last two days with sellers in complete control as prices slump across the board",
    "keywords": "",
    "snippet": "Bitcoin (BTC/USD) Price, Analysis and Chart: Bullish channel is broken in a two day sell-off...",
    "url": "https://www.dailyfx.com/forex/market_alert/2021/02/23/Bitcoin-BTCUSD-Ethereum-ETHUSD-Crushed-as-Cryptocurrency-Market-is-Overrun-by-Sellers.html",
    "image_url": "https://a.c-dn.net/b/2jPuVf/headline_shutterstock_365875643.jpg",
    "language": "en",
    "published_at": "2021-02-23T10:30:00.000000Z",
    "source": "dailyfx.com",
    "entities": [
        {
            "symbol": "BTCUSD",
            "name": "Bitcoin USD",
            "exchange": "CC",
            "exchange_long": "Cryptocurrency",
            "country": "global",
            "type": "cryptocurrency",
            "industry": "N/A",
            "match_score": 82.04055,
            "sentiment_score": -0.177075,
            "highlights": [
                {
                    "highlight": "<em>Bitcoin</em> (<em>BTC</em>/<em>USD</em>) Price, Analysis and Chart: Bullish channel is broken in a two day sell-off. No specific driver of price action.",
                    "sentiment": -0.6486,
                    "highlighted_in": "main_text"
                },
                ...
            ]
        },
        {
            "symbol": "ETHUSD",
            "name": "Ethereum USD",
            "exchange": "CC",
            "exchange_long": "Cryptocurrency",
            "country": "global",
            "type": "cryptocurrency",
            "industry": "N/A",
            "match_score": 65.22654,
            "sentiment_score": -0.4215,
            "highlights": [
                {
                    "highlight": "Bitcoin (BTC/<em>USD</em>), <em>Ethereum</em> (<em>ETH</em>/<em>USD</em>) Crushed as Cryptocurrency Market is Overrun by Sellers",
                    "sentiment": -0.4215,
                    "highlighted_in": "title"
                }
            ]
        }
    ]
}
```

--------------------------------

### GET /entities

Source: https://www.marketaux.com/documentation

Retrieve entity data based on specified filtering and sorting parameters.

```APIDOC
## GET /entities

### Description
Retrieve entity data based on specified filtering and sorting parameters.

### Method
GET

### Parameters
#### Query Parameters
- **api_token** (string) - Required - Your API token which can be found on your account dashboard.
- **group_by** (string) - Optional - Group results by symbol, exchange, industry, or country. Default: symbol.
- **min_doc_count** (integer) - Optional - The minimum number of total_documents an entity should be identified within.
- **symbols** (string) - Optional - Specify entity symbol(s) identified within the article.
- **entity_types** (string) - Optional - Specify the type of entities identified within the article.
- **industries** (string) - Optional - Specify the industries of entities identified within the article.
- **countries** (string) - Optional - Specify the country of the exchange of identified entities.
- **sentiment_avg_gte** (float) - Optional - Refine results for entities with an overall sentiment_avg greater than or equal to x.
- **sentiment_avg_lte** (float) - Optional - Refine results for entities with an overall sentiment_avg less than or equal to x.
- **sentiment_gte** (float) - Optional - Refine results for documents for entities with a sentiment_score greater than or equal to x.
- **sentiment_lte** (float) - Optional - Refine results for documents for entities with a sentiment_score less than or equal to x.
- **search** (string) - Optional - Search tool for full body and title text with support for AND, OR, negation, phrases, and prefix queries.
- **domains** (string) - Optional - Comma separated list of domains to include.
- **exclude_domains** (string) - Optional - Comma separated list of domains to exclude.
- **source_ids** (string) - Optional - Comma separated list of source_ids to include.
- **exclude_source_ids** (string) - Optional - Comma separated list of source_ids to exclude.
- **language** (string) - Optional - Comma separated list of languages to include.
- **published_before** (string) - Optional - Refine results for articles published before the specified date.
- **published_after** (string) - Optional - Refine results for articles published after the specified date.
- **published_on** (string) - Optional - Refine results for articles published on the specified date.
- **sort** (string) - Optional - Sort by total_documents or sentiment_avg. Default: total_documents.
- **sort_order** (string) - Optional - Sort order (desc or asc). Default: desc.
- **limit** (integer) - Optional - Specify the number of entities to return.
```

--------------------------------

### GET https://api.marketaux.com/v1/entity/industry/list

Source: https://www.marketaux.com/documentation

Retrieves a list of all supported entity industries.

```APIDOC
## GET https://api.marketaux.com/v1/entity/industry/list

### Description
Use this endpoint to return all supported entity industries.

### Method
GET

### Endpoint
https://api.marketaux.com/v1/entity/industry/list

### Parameters
#### Query Parameters
- **api_token** (string) - Required - Your API token which can be found on your account dashboard.

### Request Example
GET https://api.marketaux.com/v1/entity/industry/list?api_token=YOUR_API_TOKEN

### Response
#### Success Response (200)
- **data** (array) - Array of industries.

#### Response Example
{
    "data": [
        "Technology",
        "Industrials",
        "N/A",
        "Consumer Cyclical",
        "Healthcare",
        "Communication Services",
        "Financial Services",
        "Consumer Defensive",
        "Basic Materials",
        "Real Estate",
        "Energy",
        "Utilities",
        "Financial",
        "Services",
        "Consumer Goods",
        "Industrial Goods"
    ]
}
```

--------------------------------

### GET https://api.marketaux.com/v1/entity/stats/intraday

Source: https://www.marketaux.com/documentation

Get an intraday view of how well entities performed over different intervals. Useful for comparing entities and creating graphs and charts.

```APIDOC
## GET https://api.marketaux.com/v1/entity/stats/intraday

### Description
Get an intraday view of how well entities performed over different intervals using this endpoint. Find the best or worst performing entities broken down to every minute, hour, day, week, month, quarter or year.

### Method
GET

### Endpoint
https://api.marketaux.com/v1/entity/stats/intraday

### Parameters
#### Query Parameters
- **api_token** (string) - Required - Your API token which can be found on your account dashboard.
- **interval** (string) - Optional - The interval of the time series (minute, hour, day, week, month, quarter, year). Default: day.
- **group_by** (string) - Optional - Group results by symbol, exchange, industry, or country. Default: symbol.
- **min_doc_count** (integer) - Optional - The minimum number of total_documents an entity should be identified within.
- **symbols** (string) - Optional - Specify entity symbol(s) identified within the article.
- **entity_types** (string) - Optional - Specify the type of entities identified within the article.
- **industries** (string) - Optional - Specify the industries of entities identified within the article.
- **countries** (string) - Optional - Specify the country of the exchange of entities identified within the article.
- **sentiment_avg_gte** (float) - Optional - Refine results to find entities with an overall sentiment_avg greater than or equal to x.
- **sentiment_avg_lte** (float) - Optional - Refine results to find entities with an overall sentiment_avg less than or equal to x.
- **sentiment_gte** (float) - Optional - Refine results to find documents for entities with a sentiment_score greater than or equal to x.
- **sentiment_lte** (float) - Optional - Refine results to find documents for entities with a sentiment_score less than or equal to x.
- **search** (string) - Optional - Basic or advanced search tool for full body and title text.
- **domains** (string) - Optional - Comma separated list of domains to include.
- **exclude_domains** (string) - Optional - Comma separated list of domains to exclude.
- **source_ids** (string) - Optional - Comma separated list of source_ids to include.
```

--------------------------------

### GET /v1/entity/stats/intraday

Source: https://www.marketaux.com/documentation

Retrieves intraday statistics for entities, including sentiment and volume metrics.

```APIDOC
## GET /v1/entity/stats/intraday

### Description
Retrieves aggregated entity statistics based on time intervals and grouping parameters.

### Method
GET

### Endpoint
https://api.marketaux.com/v1/entity/stats/intraday
```

--------------------------------

### GET /v1/entity/stats/intraday

Source: https://www.marketaux.com/documentation

Retrieves intraday entity statistics based on provided query parameters.

```APIDOC
## GET /v1/entity/stats/intraday

### Description
Retrieves time-series statistics for entities, including total documents and average sentiment, filtered by various criteria.

### Method
GET

### Endpoint
https://api.marketaux.com/v1/entity/stats/intraday

### Parameters
#### Query Parameters
- **symbols** (string) - Required - Comma separated list of symbols.
- **interval** (string) - Required - The time interval for the statistics (e.g., day).
- **api_token** (string) - Required - Your API authentication token.
- **exclude_source_ids** (string) - Optional - Comma separated list of source_ids to exclude.
- **language** (string) - Optional - Comma separated list of languages to include.
- **published_before** (string) - Optional - Refine results for articles before the specified date.
- **published_after** (string) - Optional - Refine results for articles published after the specified date.
- **published_on** (string) - Optional - Refine results for articles published on the specified date.
- **sort** (string) - Optional - Sort by total_documents or sentiment_avg. Default: total_documents.
- **sort_order** (string) - Optional - Sort order (desc or asc). Default: desc.
- **date_order** (string) - Optional - Ordering of the date keys (desc or asc). Default: desc.
- **limit** (integer) - Optional - Specify the number of entities to return.

### Request Example
GET https://api.marketaux.com/v1/entity/stats/intraday?symbols=TSLA,AMZN,MSFT&interval=day&published_after=2026-07-25T09:48&language=en&api_token=YOUR_API_TOKEN

### Response
#### Success Response (200)
- **data > date** (string) - Date of the time series data.
- **data > data > key** (string) - The key based on the group_by parameter.
- **data > data > total_documents** (integer) - Total number of documents identified.
- **data > data > sentiment_avg** (float) - Average sentiment of the key.

#### Response Example
{
    "data": [
        {
            "date": "2024-11-10T00:00:00.000Z",
            "data": [
                {
                    "key": "TSLA",
                    "total_documents": 14,
                    "sentiment_avg": 0.388841356283852
                }
            ]
        }
    ]
}
```

--------------------------------

### GET https://api.marketaux.com/v1/news/similar/uuid

Source: https://www.marketaux.com/documentation

Retrieves a list of news articles that are similar to the article specified by the UUID in the path.

```APIDOC
## GET https://api.marketaux.com/v1/news/similar/uuid

### Description
Use this endpoint to find similar stories to a specific article based on its UUID.

### Method
GET

### Endpoint
https://api.marketaux.com/v1/news/similar/uuid

### Parameters
#### Query Parameters
- **api_token** (string) - Required - Your API token which can be found on your account dashboard.
- **symbols** (string) - Optional - Specify entity symbol(s) which have been identified within the article.
- **entity_types** (string) - Optional - Specify the type of entities which have been identified within the article.
- **industries** (string) - Optional - Specify the industries of entities which have been identified within the article.
- **countries** (string) - Optional - Specify the country of the exchange of which entities have been identified within the article.
- **sentiment_gte** (number) - Optional - Find all articles with entities with a sentiment_score of greater than or equal to x.
- **sentiment_lte** (number) - Optional - Find all articles with entities with a sentiment_score of less than or equal to x.
- **filter_entities** (boolean) - Optional - Only relevant entities to your query will be returned with each article. Default: false.
- **must_have_entities** (boolean) - Optional - Ensure that at least one entity has been identified within the article. Default: false.
- **group_similar** (boolean) - Optional - Group similar articles to avoid displaying multiple articles on the same topic/subject. Default: true.
- **domains** (string) - Optional - Comma separated list of domains to include.
- **exclude_domains** (string) - Optional - Comma separated list of domains to exclude.
- **source_ids** (string) - Optional - Comma separated list of source_ids to include.
- **exclude_source_ids** (string) - Optional - Comma separated list of source_ids to exclude.
- **language** (string) - Optional - Comma separated list of languages to include.
- **published_before** (string) - Optional - Find all articles published before the specified date.
- **published_after** (string) - Optional - Find all articles published after the specified date.
- **published_on** (string) - Optional - Find all articles published on the specified date.
- **limit** (integer) - Optional - Specify the number of articles you want to return in the request.
- **page** (integer) - Optional - Use this to paginate through the result set. Default is 1.
```

--------------------------------

### Similar News API Response Structure

Source: https://www.marketaux.com/documentation

Example JSON response showing the meta information and the array of similar news articles returned by the API.

```json
{
    "meta": {
        "found": 222,
        "returned": 3,
        "limit": 3,
        "page": 1
    },
    "data": [
        {
            "uuid": "489e4ec4-84a9-4628-966c-95c3741c6dfc",
            "title": "Bitcoin Drops below $47K: Is BTC in a Bear Market?",
            "description": "Bitcoin's rally seems to have made a sharp U-turn. Is this a short-lived correction or a longer-term trend?",
            "keywords": "",
            "snippet": "The market correction that many crypto analysts have been predicting for weeks seems to have finally arrived. Indeed, crypto markets are seeing red across the ...",
            "url": "https://www.financemagnates.com/cryptocurrency/news/bitcoin-drops-below-47k-is-btc-in-a-bear-market/",
            "image_url": "https://www.financemagnates.com/wp-content/uploads/2020/02/bitcoin-tightrope.jpg",
            "language": "en",
            "published_at": "2021-02-23T11:00:40.000000Z",
            "source": "financemagnates.com",
            "relevance_score": 106.05874,
            "entities": [ ],
            "similar": [ ]
        },
        {
            "uuid": "61be555e-3120-44b0-ad13-6f985ea92f63",
            "title": "Bitcoin ETFs vs Spot BTC",
            "description": "Bitcoin is now the largest and most well-known cryptocurrency. This cryptocurrency has a market cap of several hundred billion dollars and as a result, has ...",
            "keywords": "",
            "snippet": "Bitcoin is now the largest and most well-known cryptocurrency. This cryptocurrency has a market cap of several hundred billion dollars and as a result, has mass...",
            "url": "https://www.benzinga.com/markets/cryptocurrency/21/02/19808328/bitcoin-etfs-vs-spot-btc",
            "image_url": "https://cdn.benzinga.com/files/imagecache/og_image_social_share_1200x630/images/story/2012/investing.jpg",
            "language": "en",
            "published_at": "2021-02-23T21:11:34.000000Z",
            "source": "benzinga.com",
            "relevance_score": 95.900276,
            "entities": [ ],
            "similar": [ ]
        },
        ...
    ]
}
```

--------------------------------

### GET https://api.marketaux.com/v1/news/sources

Source: https://www.marketaux.com/documentation

Retrieves a list of available news sources that can be used in other API requests.

```APIDOC
## GET https://api.marketaux.com/v1/news/sources

### Description
Use this endpoint to view sources which can be used in other API requests. Note that the limit is 50 for all requests.

### Method
GET

### Endpoint
https://api.marketaux.com/v1/news/sources

### Parameters
#### Query Parameters
- **api_token** (string) - Required - Your API token which can be found on your account dashboard.
- **distinct_domain** (boolean) - Optional - Use this to group distinct domains from sources. This will make source_id null.
- **language** (string) - Optional - Comma separated list of languages to include. Default is all.
- **page** (integer) - Optional - Use this to paginate through the result set. Default is 1.

### Response
#### Success Response (200)
- **meta > found** (integer) - The number of sources found for the request.
- **meta > returned** (integer) - The number of sources returned on the page.
- **meta > limit** (integer) - The limit is 50.
- **meta > page** (integer) - The page number based on the page parameter.
- **data > source_id** (string) - The unique ID of the source feed.
- **data > domain** (string) - The domain of the source.
- **data > language** (string) - The source language.

### Response Example
{
    "meta": {
        "found": 5327,
        "returned": 50,
        "limit": 50,
        "page": 1
    },
    "data": [
        {
            "source_id": "adweek.com-1",
            "domain": "adweek.com",
            "language": "en"
        }
    ]
}
```

--------------------------------

### Fetch news data with JavaScript

Source: https://www.marketaux.com/documentation

Uses the Fetch API to perform an asynchronous GET request.

```javascript
var requestOptions = {
    method: 'GET'
};

var params = {
    api_token: 'YOUR_API_TOKEN',
    symbols: 'msft,fb',
    limit: '50'
};

var esc = encodeURIComponent;
var query = Object.keys(params)
    .map(function(k) {return esc(k) + '=' + esc(params[k]);})
    .join('&');

fetch("https://api.marketaux.com/v1/news/all?" + query, requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));
```

--------------------------------

### GET https://api.marketaux.com/v1/news/uuid/{uuid}

Source: https://www.marketaux.com/documentation

Retrieve a specific news article by its unique UUID.

```APIDOC
## GET https://api.marketaux.com/v1/news/uuid/{uuid}

### Description
Use this endpoint to find specific articles by the UUID which is returned on our search endpoints. This is useful if you wish to store the UUID to return the article later.

### Method
GET

### Endpoint
https://api.marketaux.com/v1/news/uuid/{uuid}

### Parameters
#### Path Parameters
- **uuid** (string) - Required - The unique identifier for an article.

#### Query Parameters
- **api_token** (string) - Required - Your API token which can be found on your account dashboard.

### Response
#### Success Response (200)
- **uuid** (string) - The unique identifier for an article.
- **title** (string) - The article title.
- **description** (string) - The article meta description.
- **keywords** (string) - The article meta keywords.
- **snippet** (string) - The first 60 characters of the article body.
- **url** (string) - The URL to the article.
- **image_url** (string) - The URL to the article image.
- **language** (string) - The language of the source.
- **published_at** (string) - The datetime the article was published.
- **source** (string) - The domain of the source.
- **entities** (array) - List of identified entities in the article.

#### Response Example
{
    "uuid": "9b9fb67e-9438-4263-815e-ef6a7d36af07",
    "title": "Bitcoin (BTC/USD), Ethereum (ETH/USD) Crushed as Cryptocurrency Market is Overrun by Sellers",
    "description": "The cryptocurrency market has been experiencing wild price swings over the last two days with sellers in complete control as prices slump across the board",
    "keywords": "",
    "snippet": "Bitcoin (BTC/USD) Price, Analysis and Chart: Bullish channel is broken in a two day sell-off...",
    "url": "https://www.dailyfx.com/forex/market_alert/2021/02/23/Bitcoin-BTCUSD-Ethereum-ETHUSD-Crushed-as-Cryptocurrency-Market-is-Overrun-by-Sellers.html",
    "image_url": "https://a.c-dn.net/b/2jPuVf/headline_shutterstock_365875643.jpg",
    "language": "en",
    "published_at": "2021-02-23T10:30:00.000000Z",
    "source": "dailyfx.com",
    "entities": []
}
```

--------------------------------

### GET /v1/entity/trending/aggregation

Source: https://www.marketaux.com/documentation

Identifies trending entities based on specified time frames.

```APIDOC
## GET /v1/entity/trending/aggregation

### Description
Use this endpoint to identify trending entities. Filter by time frame and much more; e.g. find which stocks were trending on a specific day, within the past 24 hours, past 7 days, etc.

### Method
GET

### Endpoint
https://api.marketaux.com/v1/entity/trending/aggregation
```

--------------------------------

### GET /v1/news/all

Source: https://www.marketaux.com/documentation

Retrieves news articles based on various filters such as symbols, sentiment, and language.

```APIDOC
## GET /v1/news/all

### Description
Retrieves news articles based on specified filters.

### Method
GET

### Endpoint
https://api.marketaux.com/v1/news/all
```

--------------------------------

### Entity Statistics Response

Source: https://www.marketaux.com/documentation

Example JSON response structure containing meta information and aggregated data for requested symbols.

```json
{
    "meta": {
        "returned": 3,
        "limit": 100
    },
    "data": [
        {
            "key": "TSLA",
            "total_documents": 14,
            "sentiment_avg": 0.388841356283852
        },
        {
            "key": "MSFT",
            "total_documents": 10,
            "sentiment_avg": 0.3902672976255417
        },
        {
            "key": "AMZN",
            "total_documents": 1,
            "sentiment_avg": 0.7039710283279419
        }
    ]
}
```

--------------------------------

### Retrieve all financial news via HTTP GET

Source: https://www.marketaux.com/documentation

Use this endpoint to fetch the latest global financial news. Ensure the API token is included as a parameter for authentication.

```http
GET https://api.marketaux.com/v1/news/all HTTP/1.1
```

--------------------------------

### Fetch news data with PHP

Source: https://www.marketaux.com/documentation

Uses cURL to perform a GET request. Ensure the cURL extension is enabled in your PHP environment.

```php
$queryString = http_build_query([
    'api_token' => 'YOUR_API_TOKEN',
    'symbols' => 'AAPL,TSLA',
    'filter_entities' => 'true',
    'limit' => 50,
]);

$ch = curl_init(sprintf('%s?%s', 'https://api.marketaux.com/v1/news/all', $queryString));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$json = curl_exec($ch);

curl_close($ch);

$apiResult = json_decode($json, true);

print_r($apiResult);
```

--------------------------------

### Perform a Similar News API Request

Source: https://www.marketaux.com/documentation

Use this GET request to retrieve news articles similar to a specific article identified by its UUID.

```http
GET https://api.marketaux.com/v1/news/similar/cc11e3ab-ced0-4a42-9146-e426505e2e67?api_token=YOUR_API_TOKEN&language=en&published_on=2020-12-01
```

--------------------------------

### Request Entity Statistics

Source: https://www.marketaux.com/documentation

Perform a GET request to retrieve aggregated statistics for specific symbols.

```http
GET https://api.marketaux.com/v1/entity/stats/aggregation?symbols=TSLA,AMZN,MSFT&published_after=2026-07-25T09:48&language=en&api_token=YOUR_API_TOKEN
```

--------------------------------

### Marketaux API JSON Response Example

Source: https://www.marketaux.com/documentation

Represents a typical news article object returned by the API, containing metadata, entity information, and sentiment highlights.

```json
{
            "url": "https://www.investing.com/news/stock-market-news/amazoncom-mulls-new-multibillion-dollar-investment-in-anthropic-the-information-reports-3710319",
            "image_url": "https://i-invdn-com.investing.com/news/amazon_800x533_L_1411373482.jpg",
            "language": "en",
            "published_at": "2024-11-07T23:49:09.000000Z",
            "source": "investing.com",
            "relevance_score": null,
            "entities": [
                {
                    "symbol": "AMZN",
                    "name": "Amazon.com, Inc.",
                    "exchange": null,
                    "exchange_long": null,
                    "country": "us",
                    "type": "equity",
                    "industry": "Consumer Cyclical",
                    "match_score": 34.292408,
                    "sentiment_score": 0,
                    "highlights": [
                        {
                            "highlight": "<em>Amazon.com</em> mulls new multi-billion dollar investment in Anthropic, the Information reports By Reuters",
                            "sentiment": 0,
                            "highlighted_in": "title"
                        }
                    ]
                }
            ],
            "similar": []
        },
        {
            "uuid": "2ca2cbbf-c613-4d1c-b470-9d1bac3a256a",
            "title": "Market Soars to Record Highs: November 7, 2024 Stock Market Recap",
            "description": "The U.S. stock market experienced a historic surge on Thursday, November 7, 2024, as investors reacted to Donald Trump's unexpected victory in the 2024 U.S.",
            "keywords": "",
            "snippet": "Why Was the Market Up Today? Trump’s Victory Sparks Rally\n\nThe U.S. stock market experienced a historic surge on Thursday, November 7, 2024, as investors reac...",
            "url": "https://thestockmarketwatch.com/stock-market-news/market-soars-to-record-highs-november-7-2024-stock-market-recap/48362/",
            "image_url": "https://thestockmarketwatch.com/stock-market-news/wp-content/uploads/2024/08/5.jpg",
            "language": "en",
            "published_at": "2024-11-07T22:28:28.000000Z",
            "source": "thestockmarketwatch.com",
            "relevance_score": null,
            "entities": [
                {
                    "symbol": "TSLA",
                    "name": "Tesla, Inc.",
                    "exchange": null,
                    "exchange_long": null,
                    "country": "us",
                    "type": "equity",
                    "industry": "Consumer Cyclical",
                    "match_score": 17.491323,
                    "sentiment_score": 0.7783,
                    "highlights": [
                        {
                            "highlight": "<em>Tesla</em>, <em>Inc</em>. (TSLA), wh[+166 characters]",
                            "sentiment": 0.7783,
                            "highlighted_in": "main_text"
                        }
                    ]
                }
            ],
            "similar": []
        }
```

--------------------------------

### Marketaux News API Response

Source: https://www.marketaux.com/documentation

Example JSON response body containing meta information and a list of news articles with entity details.

```json
{
    "meta": {
        "found": 140037,
        "returned": 3,
        "limit": 3,
        "page": 1
    },
    "data": [
        {
            "uuid": "70cb577e-c2dd-4dde-b501-f713823a4939",
            "title": "Trump wins 2024, markets surge globally",
            "description": "Global markets experience a significant surge following Trump's victory in the 2024 election.",
            "keywords": "",
            "snippet": "Donald Trump has won the 2024 presidential election, defeating Vice President Kamala Harris. Trump secured the 270 electoral votes needed for victory after winn...",
            "url": "https://www.killerstartups.com/trump-wins-2024-markets-surge-globally/",
            "image_url": "https://images.killerstartups.com/wp-content/uploads/2024/11/Trump-Wins.jpg",
            "language": "en",
            "published_at": "2024-11-08T01:24:00.000000Z",
            "source": "killerstartups.com",
            "relevance_score": null,
            "entities": [
                {
                    "symbol": "TSLA",
                    "name": "Tesla, Inc.",
                    "exchange": null,
                    "exchange_long": null,
                    "country": "us",
                    "type": "equity",
                    "industry": "Consumer Cyclical",
                    "match_score": 12.133104,
                    "sentiment_score": 0.7783,
                    "highlights": [
                        {
                            "highlight": "., majority-owned by Trump, and Tesl[+253 characters]",
                            "sentiment": 0.7783,
                            "highlighted_in": "main_text"
                        }
                    ]
                }
            ],
            "similar": []
        },
        {
            "uuid": "ed35bdcd-6f6a-4007-9949-b769fbe2e36d",
            "title": "Amazon.com mulls new multi-billion dollar investment in Anthropic, the Information reports By Reuters",
            "description": "Amazon.com mulls new multi-billion dollar investment in Anthropic, the Information reports",
            "keywords": "",
            "snippet": "(Reuters) -Amazon is in talks for its second multi-billion dollar investment in artificial intelligence startup Anthropic, the Information reported on Thursday,..."
```

--------------------------------

### Entity Search Endpoint Definition

Source: https://www.marketaux.com/documentation

The base endpoint for performing entity searches via HTTP GET.

```http
GET https://api.marketaux.com/v1/entity/search HTTP/1.1
```

--------------------------------

### Entity Stats Endpoint Request

Source: https://www.marketaux.com/documentation

The base HTTP GET request for retrieving intraday entity statistics.

```http
GET https://api.marketaux.com/v1/entity/stats/intraday HTTP/1.1
```
Tokens:
Raw