> For the complete documentation index, see [llms.txt](https://docs.chaingpt.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chaingpt.org/dev-docs-b2b-saas-api-and-sdk/chaingpt-claude-skill-and-plugin/products/crypto-news.md).

# Crypto News

## Crypto News

Real-time AI-curated cryptocurrency and blockchain news powered by the Nova AI engine. Access 24 categories, filter by 50+ blockchains and 30+ tokens, and consume via REST API or free RSS feeds.

### Key Facts

|                        |                            |
| ---------------------- | -------------------------- |
| **Endpoint**           | `GET /news`                |
| **Cost**               | 1 credit per 10 records    |
| **SDK**                | `@chaingpt/ainews`         |
| **Categories**         | 24                         |
| **Blockchain Filters** | 50+                        |
| **Token Filters**      | 30+                        |
| **RSS**                | Free (no credits required) |

### RSS Feeds

Free RSS feeds are available without API authentication:

| Feed     | URL                                              |
| -------- | ------------------------------------------------ |
| All news | `https://app.chaingpt.org/rssfeeds.xml`          |
| Bitcoin  | `https://app.chaingpt.org/rssfeeds-bitcoin.xml`  |
| BNB      | `https://app.chaingpt.org/rssfeeds-bnb.xml`      |
| Ethereum | `https://app.chaingpt.org/rssfeeds-ethereum.xml` |

### Quick Start -- JavaScript

```bash
npm install @chaingpt/ainews
```

#### Fetch Latest News

```javascript
import { AiNews } from "@chaingpt/ainews";

const client = new AiNews({
  apiKey: process.env.CHAINGPT_API_KEY,
});

const news = await client.getNews({
  limit: 10,
});

for (const article of news.data) {
  console.log(`[${article.category}] ${article.title}`);
  console.log(`  ${article.summary}`);
  console.log(`  ${article.url}\n`);
}
```

#### Filter by Category

```javascript
const defiNews = await client.getNews({
  category: "DeFi",
  limit: 5,
});

for (const article of defiNews.data) {
  console.log(`${article.title} - ${article.publishedAt}`);
}
```

#### Filter by Blockchain and Token

```javascript
const ethNews = await client.getNews({
  blockchain: "Ethereum",
  token: "ETH",
  limit: 10,
});

for (const article of ethNews.data) {
  console.log(`${article.title}`);
  console.log(`  Summary: ${article.summary}\n`);
}
```

### Categories

The Nova AI engine classifies articles into 24 categories including (but not limited to):

* DeFi
* NFT
* Layer 1 / Layer 2
* Regulation
* Exchange
* Mining
* GameFi
* Metaverse
* Security
* Stablecoin

See the reference/ docs for the complete category list.

### Tips

* Use the free RSS feeds for simple integrations that do not need filtering or pagination -- no API key or credits required.
* At 1 credit per 10 records, the news endpoint is cost-effective for bulk retrieval.
* Combine with the Web3 AI Chatbot by injecting news articles via `contextInjection` to get AI-analyzed market summaries.
* Feed news into AgenticOS to power autonomous X/Twitter bots with timely, relevant content.
* Use blockchain and token filters together for highly targeted feeds (e.g., Ethereum DeFi news only).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.chaingpt.org/dev-docs-b2b-saas-api-and-sdk/chaingpt-claude-skill-and-plugin/products/crypto-news.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.