Getting started with the
Urd Atlas JSON API

curl -H "X-API-Key: YOUR_KEY_HERE" https://urdatlas.com/api/v1/files/meta/bitcoin/latest.json

curl -H "X-API-Key: YOUR_KEY_HERE" https://urdatlas.com/api/v1/files/meta/bitcoin/latest.json -o meta_bitcoin_latest.json

import requests, json

API_KEY = "YOUR_KEY_HERE"
url = "https://urdatlas.com/api/v1/files/meta/bitcoin/latest.json"

response = requests.get(url, headers={"X-API-Key": API_KEY}, timeout=30)
response.raise_for_status()  # raises an error if request failed

data = response.json()
print(data["status"]["label"])         # prints e.g. HEATING
print(data["confidence"]["confidence_score"])  # prints e.g. 0.82

# Save to file
with open("meta_bitcoin_latest.json", "w") as f:
    json.dump(data, f, indent=2)

$key = "YOUR_KEY_HERE"
$url = "https://urdatlas.com/api/v1/files/meta/bitcoin/latest.json"
$headers = @{ "X-API-Key" = $key }

$response = Invoke-RestMethod -Uri $url -Headers $headers
$response | ConvertTo-Json -Depth 10 | Out-File -FilePath "meta_bitcoin_latest.json"

import json

with open("meta_bitcoin_latest.json") as f:
    data = json.load(f)

label = data["status"]["label"]           # e.g. "HEATING"
confidence = data["confidence"]["confidence_score"]  # e.g. 0.82
date = data["date"]                       # e.g. "2026-04-13"

print(f"{date}: {label} (confidence: {confidence:.2f})")

import json
import pandas as pd

with open("meta_bitcoin_90d.json") as f:
    data = json.load(f)

# The days array contains one record per day
rows = []
for day in data["days"]:
    rows.append({
        "date": day["date"],
        "label": day["status"]["label"],
        "confidence": day["confidence"]["confidence_score"],
    })

df = pd.DataFrame(rows)
df["date"] = pd.to_datetime(df["date"])
df = df.sort_values("date")

print(df.tail(10))  # show last 10 rows
print(df["label"].value_counts())  # how many days each label appeared

import requests, pandas as pd

API_KEY = "YOUR_KEY_HERE"
CHAINS = ["bitcoin", "ethereum", "arbitrum", "base"]

rows = []
for chain in CHAINS:
    url = f"https://urdatlas.com/api/v1/files/meta/{chain}/latest.json"
    data = requests.get(url, headers={"X-API-Key": API_KEY}).json()
    rows.append({
        "chain": chain,
        "label": data["status"]["label"],
        "confidence": data["confidence"]["confidence_score"],
        "date": data["date"],
    })

df = pd.DataFrame(rows)
print(df.to_string(index=False))