---
title: "Get complete stored news counts by UTC time bucket"
method: GET
path: "/v1/tokens/{symbol}/news-markers"
tags: ["tokens"]
---

# Get complete stored news counts by UTC time bucket

`GET /v1/tokens/{symbol}/news-markers`

## Request

- Base URL: `https://app.legend.trade/api/rest`
- URL: `https://app.legend.trade/api/rest/v1/tokens/{symbol}/news-markers`
- Auth: HTTP bearer

## Path parameters

- `symbol` string, required

## Query parameters

- `from` string, date-time, required
- `to` string, date-time, required
- `source` string
- `type` string
- `minRelevance` number
- `bucketSeconds` 60 | 300 | 900 | 3600 | 14400 | 86400, required

## Response `200`

Successful response

- NewsMarkersOutput
  - `sources` NewsSourceState[], required
    - `source` string, required
    - `enabled` boolean, required
    - `sampled` boolean, required
    - `stale` boolean, required
    - `trackingStartedAt` string, date-time, required
    - `lastAttemptedAt` string, date-time, nullable, required
    - `lastSuccessAt` string, date-time, nullable, required
    - `latestWindowStart` string, date-time, nullable, required
    - `latestWindowEnd` string, date-time, nullable, required
    - `lastWindowTruncated` boolean, required
  - `markers` NewsMarker[], required
    - `bucketStart` string, date-time, required
    - `count` string, required
    - `distinctPublisherCount` string, required
    - `representativeEventId` string, uuid, required
    - `maxRelevanceScore` number, required

## Other responses

- `400`: Invalid input data
- `401`: Authorization not provided
- `403`: Insufficient access
- `404`: Not found
- `500`: Internal server error

## Changes

> 132 revisions in range; 1 not diffed.

- **2026-11-10** `2176bbe17116`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/legend/apis/legend-api/changes/v1/tokens/:symbol/news-markers/get.md)

---

[API](https://skmtc.dev/legend/apis/legend-api.md) - [All operations](https://skmtc.dev/legend/apis/legend-api/llms.txt) - [OpenAPI document](https://skmtc.dev/legend/apis/legend-api/revisions/9eafa8bfc86a?raw)
