# Market News

`GET` `/v1/news`

Retrieve the latest market-wide news articles and press releases - headlines, publishers, publication times and URLs - without filtering to a single ticker. Optionally filter with type=stockNews or type=pressRelease. Paginate with page and limit (default 50, max 250). Use this for “what’s happening in the markets today” surfaces, morning briefings and macro news feeds.

## Use cases

- Market overview and “today in markets” panels
- News digests on home dashboards
- Macro and cross-sector headline monitoring
- Feeding broad news into NLP or summarization tools

## Input parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `type` | string | No | Filter by article type: stockNews or pressRelease. Omit for both. |
| `page` | integer | No | Zero-based page (default 0). |
| `limit` | integer | No | Page size, 1-250 (default 50). |

## Output parameters

| Name | Type | Description |
| --- | --- | --- |
| `results` | array | News articles for this page. |
| `results[].id` | string | Article id. |
| `results[].title` | string | Headline. |
| `results[].publishedAt` | string | Publication time (ISO 8601). |
| `results[].publisher` | string | Publisher name. |
| `results[].url` | string | Article URL. |
| `results[].tickers` | array | Related tickers. |
| `total` | integer | Total articles available. |
| `page` | integer | Zero-based page index. |

## Example response

```json
{
  "results": [
    {
      "publishedDate": "2026-06-06 14:43:44",
      "publisher": "24/7 Wall Street",
      "title": "The No. 1 Reason to Buy and Hold Walmart Forever Has Virtually Nothing to Do With Its Brick-and-Mortar Stores",
      "site": "247wallst.com",
      "text": "Walmart (NYSE:WMT | WMT Price Prediction) fits the profile of a multi-decade compounder because the company has quietly built a high-margin digital flywheel that now compounds independently of any single store it operate...",
      "url": "https://247wallst.com/investing/2026/06/06/the-no-1-reason-to-buy-and-hold-walmart-forever-has-virtually-nothing-to-do-with-its-brick-and-mortar-stores/",
      "newsType": "stockNews",
      "ticker": "WMT",
      "id": "a593d7c6618b5fb75641",
      "company": "Walmart Inc."
    },
    {
      "publishedDate": "2026-06-06 14:41:42",
      "publisher": "24/7 Wall Street",
      "title": "Redwire is a Contract Success Story You'll Regret Not Buying on the Next Dip",
      "site": "247wallst.com",
      "text": "At $22.04, Redwire (NYSE:RDW) carries a ‘hold' framing, with the thesis hinging on a pullback before the risk/reward improves.",
      "url": "https://247wallst.com/investing/2026/06/06/redwire-is-a-contract-success-story-youll-regret-not-buying-on-the-next-dip/",
      "newsType": "stockNews",
      "ticker": "RDW",
      "id": "a8e680b4cec3dfb000ed",
      "company": "Redwire Corporation"
    }
  ],
  "total": 3231020,
  "page": 0
}
```

## Examples

### cURL

```bash
curl "https://api.vantafin.com/v1/news?type=stockNews&limit=50&apiKey=$VANTAFIN_API_KEY"
```

### Python

```python
from vantafin import RESTClient

client = RESTClient("vf-live-your_api_key")

result = client.get_news(type="stockNews", limit=50)

print(result)
```

### JavaScript

```javascript
import { RestClient } from "vantafin";

const client = new RestClient("vf-live-your_api_key");

const result = await client.getNews({ type: "stockNews", limit: 50 });

console.log(result);
```

### Go

```go
package main

import (
	"fmt"
	"log"

	"github.com/vantafin/vantafin-go"
)

func main() {
	client := vantafin.NewClient("vf-live-your_api_key")

	result, err := client.GetNews(vantafin.Params{"type": "stockNews", "limit": 50})
	if err != nil {
		log.Fatal(err)
	}

	fmt.Println(result)
}
```

### Java

```java
import com.vantafin.RestClient;
import com.vantafin.Params;

public class Example {
    public static void main(String[] args) throws Exception {
        RestClient client = new RestClient("vf-live-your_api_key");

        Object result = client.getNews(Params.of().set("type", "stockNews").set("limit", 50));

        System.out.println(result);
    }
}
```

### Ruby

```ruby
require "vantafin"

client = Vantafin::RestClient.new("vf-live-your_api_key")

result = client.get_news(type: "stockNews", limit: 50)

pp result
```