Free and paid split
Five packs are free. Two — earthquakes and tsunamis — use x402 payment on
Base USDC. The 402 challenge returns the exact price before
any charge.
Packs are versioned, independently queryable data units. Each one has its own coverage dates, available metrics, and access tier. Read the pack detail before writing a query.
Five packs are free. Two — earthquakes and tsunamis — use x402 payment on
Base USDC. The 402 challenge returns the exact price before
any charge.
Coverage dates, available metrics, geography scope, and row limits live in
the pack detail. Call GET /api/v1/packs/{pack_id} before
writing a query.
Core packs are stable and broadly ready. Standard packs are maintained but still evolving in scope or regional depth. Experimental packs are still maturing.
A pack bundles one or more data sources with a manifest, metadata, and coverage description into a versioned unit the runtime can catalog and query. Packs are independently discoverable — the catalog lists them, and each pack has its own detail endpoint.
| Pack | Tier | Access | Coverage |
|---|---|---|---|
currency |
core | free | 194 countries, daily / weekly / monthly FX rates |
earthquakes |
core | paid (x402) | 1M+ events, 2150 BC to present |
volcanoes |
core | free | 11K eruptions, Holocene to present |
tsunamis |
core | paid (x402) | 2.6K events, 2000 BC to present |
hurricanes |
core | free | 13K storms, 1842 to present |
un_sdg |
standard | free | 200+ countries, SDGs 1-17, 2000-2023 |
world_factbook |
standard | free | Global country-level indicators |
Every pack carries a tier that tells you what to expect:
The catalog and pack detail endpoints return everything you need before writing a query: available source ids, supported metrics, time coverage, geography scope, row limits, and a first-query example.
GET /api/v1/catalog — all live packs and their access tiers.GET /api/v1/packs/{pack_id} — full detail for one pack.Time filter shape varies by pack. Some sources use ISO date ranges. Others use year-style values. The pack detail includes a working first-query example showing the correct shape.
For a broader view of what source families are in the system and where coverage is strongest, see the source map.
The pack model is also the path for packaging your own data into the same runtime. The engine and schema model are open.