---
title: "Get single metric with interpretation"
method: GET
path: "/api/metrics/{metric}"
tags: ["Metrics"]
---

# Get single metric with interpretation

`GET /api/metrics/{metric}`

Returns signal analysis for a single metric: trend (7d/30d/90d), momentum,
confidence score, percentile ranking, and data quality.

**Available metrics (26):**

**Bitcoin:** bitcoin-price, bitcoin-market-cap, bitcoin-volume-24h, bitcoin-change-24h,
bitcoin-dominance, bitcoin-hash-rate, bitcoin-difficulty, bitcoin-tx-count,
bitcoin-tx-volume, bitcoin-active-addresses

**Macro:** fed-balance, m2-supply, treasury-10y, rrp, eur-usd, cny-usd,
yield-curve, tga, net-liquidity

**Calculated:** hash-ribbon, mvrv-proxy

**ETFs:** etf-spy, etf-qqq, etf-iwm, etf-vxx, etf-uup

## Path parameters

- `metric` string, required

## Query parameters

- `format` 'json' | 'markdown'

## Response `200`

Metric data with interpretation

- MetricData
  - `metric` string — Metric identifier
  - `display_name` string
  - `timestamp` string, date-time
  - `interpretation` Interpretation
    - `signal` 'bullish' | 'bearish' | 'neutral'
    - `confidence` number
    - `confidence_label` 'High' | 'Medium' | 'Low'
  - `trend` Trend
    - `direction` 'rising' | 'falling' | 'flat'
    - `change_7d` number
    - `change_30d` number
    - `change_90d` number
    - `momentum` 'accelerating' | 'decelerating' | 'steady'
    - `percentile` number
  - `context` string — Human-readable context summary
  - `source` string
  - `data_quality` DataQuality
    - `age_hours` number
    - `stale` boolean
    - `status` 'fresh' | 'warning' | 'stale'

## Other responses

- `401` — Authentication required
- `402` — Payment required. The body is an x402 v2 payment quote naming this resource, its price in USDC, and the accepted networks. Pay and retry with the payment header, or authenticate with an API key instead.
- `404` — Resource not found
- `429` — Rate limit exceeded

---

[API](https://skmtc.dev/prereason/apis/prereason-api.md) · [All operations](https://skmtc.dev/prereason/apis/prereason-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/prereason/prereason-api/revisions/2a607b0906fc/schema)
