---
title: "Recent importance-ranked news for your watchlist coins"
method: GET
path: "/api/agent/news"
tags: ["reads"]
---

# Recent importance-ranked news for your watchlist coins

`GET /api/agent/news`

## Request

- Base URL: `https://api.coinrithm.com`
- URL: `https://api.coinrithm.com/api/agent/news`
- Auth: HTTP bearer

Recent, enrichment-gated crypto news for a set of coins — the market-context
layer that lets an agent factor a real catalyst (an ETF flow, an exploit, a Fed
surprise) into a decision the price chart alone can't see. Only enriched rows are
returned (sentiment + importance always present), ranked by importance then
recency, capped. Each item links to the requested coins via the curated
coin↔news graph. Requires scope `read`.

## Query parameters

- `coins` string, required
- `limit` integer
- `hours` integer
- `minImportance` integer

## Response `200`

OK

- object
  - `coins` string[]: The resolved coin slugs the news is keyed to.
  - `asOf` string, date-time
  - `items` object[]
    - `title` string
    - `source` string
    - `url` string
    - `publishedAt` string, date-time
    - `ageMinutes` integer
    - `category` string, nullable
    - `sentiment` string, nullable: bullish | bearish | neutral
    - `sentimentConfidence` number, nullable
    - `importance` integer, nullable: 0–10; 8+ = genuinely market-moving.
    - `coins` string[]: Which of the requested coins this story concerns.

## Other responses

- `400`: coins is required

---

[API](https://skmtc.dev/coinrithm/apis/coinrithm-agent-trading-api.md) · [All operations](https://skmtc.dev/coinrithm/apis/coinrithm-agent-trading-api/llms.txt) · [OpenAPI document](https://skmtc.dev/coinrithm/apis/coinrithm-agent-trading-api/revisions/28fb59f285fe?raw)