API Docs

Historical access

History is available immediately when a paid subscription becomes active. Single Chain includes 90 days on the selected chain. Research includes the full published history across Bitcoin, Ethereum, Arbitrum and Base.

← Back to API Docs Getting started

Entitlements

What each plan can retrieve

Single Chain · $49/month

90 days · one selected chain

Single Chain gives immediate authenticated access to the latest, 7d, 30d and 90d bundle files for Gold, Derived and Meta on the selected chain, plus the latest per-chain Briefs file.

curl -H "X-API-Key: YOUR_KEY" \
  https://www.urdatlas.com/api/v1/files/meta/ethereum/90d/latest.json

Research · $149/month

Full published history · all four chains

Research includes the standard bundle windows through 365d and also unlocks the complete published archive. The archive grows as new daily records are published; it is not capped at a fixed number of days.

# Discover every published Meta date
curl -H "X-API-Key: YOUR_KEY" \
  https://www.urdatlas.com/api/v1/files/meta/ethereum/manifest.json

# Fetch one original published day file
curl -H "X-API-Key: YOUR_KEY" \
  https://www.urdatlas.com/api/v1/files/meta/ethereum/2024-12-01.json

Archive model

Manifest first, then original day files

Full history is deliberately exposed as the published manifest plus individual day files rather than one ever-growing response. This preserves the same versioned artifacts used elsewhere in Urd Atlas and lets an ingestion job fetch only the dates it is missing.

Gold / Derived / Meta

/api/v1/files/meta/bitcoin/manifest.json

/api/v1/files/meta/bitcoin/YYYY-MM-DD.json

Briefs

/api/v1/files/briefs/chains/bitcoin/manifest.json

/api/v1/files/briefs/chains/bitcoin/YYYY-MM-DD.json

Practical use

Bootstrap once, then ingest daily

A new Single Chain subscriber can bootstrap with the 90d bundle and then append latest.json each day. A Research subscriber can bootstrap the complete archive by reading each genre manifest and downloading the published dates required by the workflow, then continue with daily delivery.

Need the field contract as well? Open the schema reference →