Widget, badge and API

Show where Bitcoin stands against its fair value on your own site, free. All of it updates by itself.

Badge

One line for a README, forum signature or blog sidebar.

Markdown

[![Bitcoin fair value](https://fairvalue.cc/badge.svg)](https://fairvalue.cc/?utm_source=badge)

HTML

<a href="https://fairvalue.cc/?utm_source=badge"><img src="https://fairvalue.cc/badge.svg" alt="Bitcoin fair value" height="20"></a>

Widget

A small card with price, verdict and the position between bottom and top. No cookies and no tracking inside the frame.

Dark

<iframe src="https://fairvalue.cc/widget" title="Bitcoin fair value" width="340" height="130" style="border:0;border-radius:12px;max-width:100%" loading="lazy"></iframe>

Light

<iframe src="https://fairvalue.cc/widget?theme=light" title="Bitcoin fair value" width="340" height="130" style="border:0;border-radius:12px;max-width:100%" loading="lazy"></iframe>

API

Today's numbers as JSON, for bots, dashboards, Home Assistant or your own app. No key needed. Values refresh every five minutes, so please don't poll more often than that.

https://fairvalue.cc/api/v1/today

Example response

{
    "date": "2026-11-05",
    "price_time": "…",
    "price_usd": 80545.35,
    "fair_value_usd": 115573,
    "bottom_usd": 65887,
    "top_usd": 284238,
    "power_law_usd": 122311,
    "price_to_fair": 0.6969,
    "position": 0.1374,
    "verdict": "30% below fair value",
    "source": "https://fairvalue.cc",
    "terms": "…"
}

price_to_fair is price divided by fair value (0.67 means 33% below). position runs from 0 on the bottom line to 1 on the top line, on a log scale.

Home Assistant

# configuration.yaml
rest:
  - resource: https://fairvalue.cc/api/v1/today
    scan_interval: 900
    sensor:
      - name: Bitcoin fair value
        value_template: "{{ value_json.fair_value_usd }}"
        unit_of_measurement: USD
      - name: Bitcoin vs fair value
        value_template: "{{ ((value_json.price_to_fair - 1) * 100) | round(0) }}"
        unit_of_measurement: "%"

Terms

Free for personal and commercial use, as long as a visible link to fairvalue.cc stays with the numbers. The service may change or pause without notice. Not financial advice.

Model estimates, not a promise: past behaviour is no guarantee for the future. Not financial advice.