Docs / Packs

Seven published packs.
Defined coverage, metrics, and access tiers.

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.

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.

Pack detail is the authority

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.

Release tiers signal quality

Core packs are stable and broadly ready. Standard packs are maintained but still evolving in scope or regional depth. Experimental packs are still maturing.

What a pack is

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.

The seven live packs

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

Release tiers

Every pack carries a tier that tells you what to expect:

  • Core — stable, broadly ready, default surfaces in the hosted lane.
  • Standard — maintained and publicly available, still evolving in scope, freshness, or regional depth.
  • Experimental — still maturing or region-specific. Marked directly rather than presented as stable.
  • Private — partner-restricted or not yet published.

Pack metadata

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.

Coverage inventory

For a broader view of what source families are in the system and where coverage is strongest, see the source map.

Browse the source map

Contributing a pack

The pack model is also the path for packaging your own data into the same runtime. The engine and schema model are open.

Read the pack tutorial