---
title: "Composite reading for one asset"
method: GET
path: "/api/markets/signals/{slug}"
tags: ["Crypto"]
---

# Composite reading for one asset

`GET /api/markets/signals/{slug}`

## Request

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

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

## Path parameters

- `slug` string, required

## Response `200`

OK

- object
  - `data` object
    - `asset` object: { slug, name, kind }
    - `news` object: { score, articleCount, window }: tone of recent headlines about the asset, -1 to +1, how many headlines it covers, and the window (24h)
    - `crowd` object, nullable: { fundingRate, fundingPercentile30d, longShortRatio, score }: the current funding rate, its rank from 0 to 100 against its own recent history, and the crowd score (-1 to +1), where a high reading means traders are paying more than usual to hold longs in that asset and a low reading less than usual; longShortRatio is reserved and null; null for assets without a perpetual
    - `institutional` object, nullable: { cotNetPosition, cotIndex1y, reportDate, score }: the net position in contracts of leveraged funds (managed money for commodities), its rank from 0 to 100 against its own history, the CFTC report date, and the institutional score (-1 to +1); null without a CFTC market
    - `macro` object: { fearGreed }: the Crypto Fear & Greed Index by alternative.me; credit alternative.me next to the value when you show it
    - `composite` number, nullable: One reading from -1 to +1 for the asset; higher is more bullish; null when no component has data
    - `updatedAt` object: { news, crowd, institutional }: when each component last changed
    - `disclaimer` string: Informational only. Not financial advice.
    - `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)