---
title: "News sentiment candles for a metal"
method: GET
path: "/v1/news/sentiment/candles/{symbol}"
tags: ["News"]
---

# News sentiment candles for a metal

`GET /v1/news/sentiment/candles/{symbol}`

## Request

- Base URL: `https://api.metalcharts.org`
- URL: `https://api.metalcharts.org/v1/news/sentiment/candles/{symbol}`
- Auth: none declared

News sentiment aggregated into OHLC-style candles, so sentiment can be charted alongside price. Requires the Ultimate plan.

## Path parameters

- `symbol` string, required

## Query parameters

- `interval` string
- `range` string

## Response `200`

Success.

- object
  - `success` boolean, required
  - `symbol` string
  - `interval` string
  - `range` string
  - `data` object[], required
    - `avgConfidence` number
    - `avgScore` number
    - `bearishCount` number
    - `bullishCount` number
    - `close` number
    - `high` number
    - `low` number
    - `neutralCount` number
    - `open` number
    - `timestamp` string, date-time
    - `volume` number
  - `count` number
  - `timestamp` string, date-time

## Other responses

- `400`: Invalid parameter.

---

[API](https://skmtc.dev/metalcharts/apis/metalcharts-api.md) · [All operations](https://skmtc.dev/metalcharts/apis/metalcharts-api/llms.txt) · [OpenAPI document](https://skmtc.dev/metalcharts/apis/metalcharts-api/revisions/53d6a0af0479?raw)