---
title: "Latest sentiment scores for every tracked asset"
method: GET
path: "/api/markets/sentiment"
tags: ["Crypto"]
---

# Latest sentiment scores for every tracked asset

`GET /api/markets/sentiment`

## Request

- Base URL: `https://xoomar.com`
- URL: `https://xoomar.com/api/markets/sentiment`
- Auth: one of:
  - none
  - API key in header `x-api-key`

Docs: https://xoomar.com/markets/api/sentiment

## Query parameters

- `window` '5m' | '15m' | '1h' | '24h' | '7d' | '30d'
- `asset` string
- `kind` 'crypto' | 'fx' | 'index' | 'commodity' | 'equity'

## Response `200`

OK

- object
  - `data` object
    - `totalAssets` number: Assets in the response
    - `window` string: Window of the scores: 5m, 15m, 1h, 24h (default), 7d or 30d
    - `cadence` string: How often the scores update
    - `data` object[]: One record per asset, latest scores
      - `slug` string: Asset slug (btc, gold, sp500...)
      - `name` string: Display name
      - `kind` string: crypto, fx, index, commodity or equity
      - `window` string: The window of this record
      - `timestamp` string: When this score was computed (ISO)
      - `compositeScore` number: One reading from -1 to +1 for the asset; higher is more bullish
      - `sentimentLabel` string: BULLISH, NEUTRAL or BEARISH: the band compositeScore falls in
      - `newsLayer` object: { score, articlesCount }: tone of recent headlines about the asset, -1 to +1, and how many headlines it covers
      - `crowdLayer` object: { score }: how traders are leaning on the exchanges right now (for stocks, how heavily the stock is sold short), -1 to +1; null where it doesn't apply
      - `institutionalLayer` object: { score }: institutional positioning from the CFTC report, -1 to +1; null where no CFTC market covers the asset
      - `fearGreedIndex` number, nullable: Crypto Fear & Greed Index by alternative.me (crypto assets only; credit alternative.me next to the value when you show it)
      - `divergenceAlert` object: { signal, message }: a note when the components point different ways, or agree strongly
      - `metadata` object: { sampleHeadlines }: up to three recent headlines about the asset, each with its tone from -1 to +1
      - `canonicalUrl` string, uri: The matching page on xoomar.com
    - `canonicalUrl` string, uri: The matching page on xoomar.com
  - `updatedAt` string, date-time: When the response was built; a few dated feeds give the date of their newest row instead
  - `source` 'xoomar.com'
  - `docs` string
  - `license` string: Data terms
  - `attribution` string
  - `canonicalUrl` string, uri: The matching page on xoomar.com
  - `meta` object: Who publishes the data and how to credit it
    - `source` string: The publisher or publishers of the data, comma-separated
    - `sourceAttribution` string: The credit line to show wherever the data is displayed
    - `notice` string: Requests without a key only: the free key, app registration and the credit

## Other responses

- `404`: Unknown slug, ticker or country
- `429`: Rate limit: 10 requests a minute without a key, 30 with a free key

---

[API](https://skmtc.dev/xoomar/apis/xoomar-market-data-api.md) · [All operations](https://skmtc.dev/xoomar/apis/xoomar-market-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/xoomar/apis/xoomar-market-data-api/revisions/07b78401eaaa?raw)