# KosmoStream

> Location- and date-based biodynamic planting intelligence — weather, geomagnetic Kp index, moon
> phase, and planting outlook for any coordinates and date. Paid per request in USDC on Base via
> the x402 protocol; no account, API key, or subscription required.

KosmoStream is x402-native: every paid endpoint below returns an HTTP 402 with machine-readable
payment instructions (price, asset, network) on the first unauthenticated request. Pay by attaching
a signed EIP-3009 `transferWithAuthorization` for USDC on Base mainnet (CAIP-2 `eip155:8453`, USDC
contract `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`) and retrying the same request — the standard
pattern for this is `@x402/fetch`'s `wrapFetchWithPayment`, which handles the fetch → 402 →
sign → retry cycle in one call.

## API

- [OpenAPI spec](https://kosmostream-iaas.kosmogrow.workers.dev/openapi.json): every paid endpoint,
  its price, and its parameters, in machine-readable form — start here for programmatic discovery.
  (`GET /` on this same origin returns this identical spec when requested with
  `Accept: application/json`.)
- [x402 discovery manifest](https://kosmostream-iaas.kosmogrow.workers.dev/.well-known/x402): one
  concrete payable URL per endpoint shape, plus the receiving address, for x402-aware
  crawlers/marketplaces.
- `GET /v1/section/bd-today/{lat}/{lon}/{date}` — $0.008 USD — cheapest single-section sample.
- `GET /v1/report/{lat}/{lon}/{date}` — $0.08 USD — full report.
- `GET /v1/report/full/{lat}/{lon}/{date}` — $0.125 USD — all 8 sections with biodynamic-day and moon-phase planning window extended to 90 days.

`lat`/`lon` are decimal degrees; `date` is ISO `YYYY-MM-DD`.

## Knowledge base

Separate from the planting reports above — authored long-form guides (soil blends, growing
techniques, pest/plant field guides). Scaffolding phase: placeholder content only as of 2026-08-08.

- `GET /v1/knowledge` — free, no payment — lists every item with its category, price, and a
  one-line summary. `GET /v1/knowledge/{category}` scopes the list to one category.
- `GET /v1/knowledge/{category}/{slug}` — paid, price varies per item (see the directory above for
  the real price before buying) — one item's full Markdown content.

## Human checkout

- [kosmostream-iaas.kosmogrow.workers.dev](https://kosmostream-iaas.kosmogrow.workers.dev/):
  browser-based checkout — connect a wallet (MetaMask, Coinbase Wallet, Rabby), browse the catalog,
  pay, and read the result as a formatted report or download it as a PDF, or grab the raw JSON to
  hand to an agent instead of paying twice. Generic by design — points at any x402 seller's own
  `/openapi.json`, not just this one.

## Optional

- [KosmoGrow](https://kosmogrow.com): the project this API is part of.