---
title: "Get detailed data for a single coin"
method: GET
path: "/api/coin/{symbol}"
tags: ["Coins"]
---

# Get detailed data for a single coin

`GET /api/coin/{symbol}`

## Request

- Base URL: `https://truevaluerankings.com`
- URL: `https://truevaluerankings.com/api/coin/{symbol}`
- Auth: none required

Returns comprehensive data for a specific cryptocurrency including all 8 metric scores, TVR Score, TVR Estimated Value, valuation category, fair value gap, market data, and recovery modifier information. Use uppercase ticker symbols (BTC, ETH, LTC, etc.).

## Path parameters

- `symbol` 'BTC' | 'ETH' | 'LTC' | 'XMR' | 'LINK' | 'ADA' | 'SOL' | 'AVAX' | 'POL' | 'DOT', required

## Response `200`

Coin details

- object
  - `success` boolean
  - `coin` CoinDetail: A cryptocurrency with its full TVR analysis
    - `symbol` string: Uppercase ticker symbol
    - `name` string: Full coin name
    - `rank` integer: TVR rank position (1 = strongest fundamentals relative to price)
    - `scores` object: Individual metric scores (0-100 each)
      - `economicModel` number: Supply cap, inflation, distribution, sustainability (Weight: 41)
      - `networkSecurity` number: Consensus robustness, decentralization, resilience (Weight: 17)
      - `adoption` number: Transaction activity, merchant/institutional use, ecosystem (Weight: 13)
      - `privacy` number: Default privacy level, fungibility (Weight: 4)
      - `longevity` number: How long the network has operated successfully (Weight: 8)
      - `liquidity` number: Volume, exchange availability, market depth (Weight: 9)
      - `legalClarity` number: Regulatory status, global stance, team legal record (Weight: 4)
      - `technicalDev` number: Dev activity, upgrade track record, leadership resilience (Weight: 4)
    - `tvrScore` number: Composite TVR Score (0-100). Higher = stronger fundamentals.
    - `currentPrice` number: Current market price in USD
    - `currentMarketCap` number: Current market capitalization in USD
    - `tvrPrice` number, nullable: TVR fair value estimate in USD. Null if fair value is hidden (insufficient confidence).
    - `tvrMarketCap` number, nullable: TVR estimated market cap based on fair value. Null if fair value is hidden.
    - `valuation` 'Undervalued' | 'Fair Value' | 'Overvalued': Valuation category based on comparing TVR Estimated Value to current market price
    - `fairValueGap` number: Percentage difference between TVR Estimated Value and current price. Positive = undervalued, negative = overvalued.
    - `recoveryModifier` number: Modifier applied to fair value calculation (0.0 to 1.0)
    - `shareDeclinePct` number: Market share decline from baseline percentage
  - `source` string
  - `source_url` string
  - `attribution` string

## Other responses

- `404`: The requested resource was not found
- `429`: Too many requests. Wait and retry.
- `500`: An unexpected server error occurred

---

[API](https://skmtc.dev/truevaluerankings/apis/true-value-rankings-api.md) · [All operations](https://skmtc.dev/truevaluerankings/apis/true-value-rankings-api/llms.txt) · [OpenAPI document](https://skmtc.dev/truevaluerankings/apis/true-value-rankings-api/revisions/c2cb1728b93c?raw)