URD ATLAS
AccountGet Started
Urd Atlas publishes four JSON genres: Gold, Derived, Meta and Briefs. Paid access lets your own tools retrieve those published artifacts with an X-API-Key. The API key is checked against the account's current subscription each time it is used.
Basic includes authenticated daily delivery plus the latest, 7d, 30d and 90d bundle files for the selected chain. You do not have to wait 90 days after subscribing; the historical window is available immediately.
Pro includes Bitcoin, Ethereum, Arbitrum and Base, the standard bundle windows through 365d, and the complete published archive. Full history is not capped at 365 days; it grows as new daily records are published.
After checkout, open Dashboard and create an API key. Copy the full key when it is shown and store it like a password. Subscriber file delivery expects the key in the X-API-Key request header.
Start with one current file before attempting history or automation. Meta is the shortest path to the daily regime label, confidence and drivers.
curl -H "X-API-Key: YOUR_KEY" \
https://www.urdatlas.com/api/v1/files/meta/ethereum/latest.jsonUse the 90d bundle once to bootstrap your local dataset, then append the current latest.json file as new days are published.
curl -H "X-API-Key: YOUR_KEY" \
https://www.urdatlas.com/api/v1/files/meta/ethereum/90d/latest.jsonRead the manifest for the genre and chain, then fetch whichever original daily artifacts your workflow needs. This avoids one ever-growing response and preserves the published day files 1:1.
# Discover published dates
curl -H "X-API-Key: YOUR_KEY" \
https://www.urdatlas.com/api/v1/files/meta/ethereum/manifest.json
# Fetch one published day
curl -H "X-API-Key: YOUR_KEY" \
https://www.urdatlas.com/api/v1/files/meta/ethereum/2024-12-01.json| Path token | Meaning | Available on |
|---|---|---|
latest | Most recent published day | Basic + Pro |
7d | Rolling 7-day bundle | Basic + Pro |
30d | Rolling 30-day bundle | Basic + Pro |
90d | Rolling 90-day bundle | Basic + Pro |
180d | Rolling 180-day bundle | Pro |
365d | Rolling 365-day bundle | Pro |
manifest.json + YYYY-MM-DD.json | Complete published archive | Pro |
Regime, confidence, status, scorecard and drivers.
Canonical daily on-chain measurements.
Published rolling and derived feature context.
Readable summaries generated from the published state layer.
Gold, Derived and Meta use /api/v1/files/[genre]/[chain]/.... Briefs use /api/v1/files/briefs/chains/[chain]/....
Urd Atlas publishes the new artifacts; your system fetches them. For normal daily ingestion, check the public Status endpoint and fetch latest.json when a new published date appears. You do not need to redownload the entire history every day.