# Micro Data API Factory — Broker

> Wallet-free API-key issuance + free-trial credit + metered broker call
> for the Micro Data API Factory products. No signup, no wallet.
> POST /keys/create → get a key, get trial credit, start calling.

## Quick start

1. curl -X POST https://broker-entry-api.kasanegi123.workers.dev/keys/create
   → returns { api_key, entitlements, balance_micro_usdc, ... } ONCE.
2. curl -H "X-API-Key: <key>" "https://broker-entry-api.kasanegi123.workers.dev/products"
   → list products you can call.
3. curl -X POST -H "X-API-Key: <key>" -H "Content-Type: application/json" \
        --data '{"product_id":"weather-v1-current","query":{"city":"Tokyo"}}' \
        https://broker-entry-api.kasanegi123.workers.dev/broker/call
   → weather JSON, balance decremented.

## Model

- **product**: an API surface (e.g. weather-v1-current). Versioned by variant.
- **endpoint**: path under a product (e.g. /weather/current).
- **api_key**: wallet-free bearer; hashed in storage.
- **credit_ledger**: + grants (trial) / − consumptions (broker calls).
- **entitlements**: which products a key can call, with policy.
- **trial_policies**: active trials; each new key auto-receives them.

## Factory principle

Adding a new product is an INSERT INTO products + INSERT INTO endpoints
(+ optional INSERT INTO trial_policies). No schema migration, no broker
redeploy. The broker route is generic.

## Pricing

- Default free trial: $0.005 per active policy (covers 5 calls on the
  $0.001 class).
- After trial expires: fall back to direct paid URL (x402 on Base mainnet)
  or an extended plan (not yet offered in v1).
- Broker never charges above the direct product price; it only meters.

## Attribution & source

Each product carries its own upstream attribution (see product detail).

## Discovery

- /.well-known/broker-manifest.json — machine-readable product list
- /products — JSON product catalog
- /openapi.json — OpenAPI 3.1.0