---
title: "Alt-vs-BTC strength — one pair"
method: GET
path: "/api/v1/alt-vs-btc-strength/{pair}"
tags: ["Snapshots"]
---

# Alt-vs-BTC strength — one pair

`GET /api/v1/alt-vs-btc-strength/{pair}`

## Request

- Base URL: `https://tradingstrategies.work`
- URL: `https://tradingstrategies.work/api/v1/alt-vs-btc-strength/{pair}`
- Auth: HTTP bearer

One pair from the alt_vs_btc_strength snapshot: ALT/BTC ratio return per window (1d…365d, null when younger than the window), USD return 30d, last close in USD and in BTC, the 52-week vs-BTC sparkline (weekly closes normalized to 1 at the start), the trend state, and its rank per window among all fresh pairs with a value (rank null when stale or without value). Same service as the click card on /dashboard/altcoins/vs-bitcoin. Descriptive, NOT a signal — see base_rate_context. [Free tier]

## Path parameters

- `pair` string, required

## Response `200`

Latest snapshot with tier echo.

- object

## Other responses

- `400`: Invalid input — fehlt Pflichtfeld oder Wert außerhalb des erlaubten Bereichs.
- `401`: Unauthenticated — kein gültiger Bearer-Token im Authorization-Header.
- `403`: Tier-Insufficient — Endpoint braucht höheren API-Tier. Response enthält upgrade_url.
- `404`: Not-Found — Resource existiert nicht oder gehört nicht dem aktuellen User.
- `429`: Rate-Limit überschritten — Tier-Quota (hourly/daily) oder Per-Endpoint-Quota erreicht. Retry-After-Header gesetzt.
- `500`: Internal Error.
- `503`: Upstream-Failure — Datenquelle nicht erreichbar (Binance, EODHD, etc.).

---

[API](https://skmtc.dev/tradingstrategies/apis/backtesting-arena-public-api.md) · [All operations](https://skmtc.dev/tradingstrategies/apis/backtesting-arena-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tradingstrategies/apis/backtesting-arena-public-api/revisions/f82e8d6eecd7?raw)
