Documentation

Protocol reference.

Object model, agent interface, registry vocabulary, and payload shape — in plain language, for builders and analysts.For the partner-facing narrative, read /mechanism.

API preview

REST endpoints (preview).

GET/v1/packs?sector=shipping-chokepoints&lifecycle=snapshot

List packs by sector and lifecycle.

GET/v1/packs/:id

Fetch one pack and its preview metadata.

POST/v1/packs

Publish a new pack against a known template.

GET/v1/requests?status=open

List open Request Briefs for matching.

POST/v1/requests

Publish a new buyer brief.

POST/v1/responses

Submit a response offer against a brief.

Sample Pack payload

Key names and value shapes follow the current DataPackmodel, trimmed to the fields most useful at first glance.

{
  "id": "pack-hk-weather-settlement-2026-04-27",
  "slug": "hk-weather-settlement-source-apr27",
  "title": "Hong Kong official weather reading for Apr 27",
  "sectorSlugs": [
    "weather-settlement"
  ],
  "templateId": "WEATHER_SETTLEMENT_SOURCE_STREAM",
  "sellerId": "seller-retail-data-labs",
  "summary": "Official HKO high-temperature monitor with station source, one-decimal reading, rounding rule, source-page archive, and nowcast delta.",
  "preview": [
    "HKO source page archived every 5 minutes",
    "One-decimal reading reconciled with settlement rule",
    "Station-level divergence flagged before market close",
    "Rounding note attached to every revision"
  ],
  "manifestCounts": [
    {
      "kind": "Official readings",
      "count": 48
    },
    {
      "kind": "Source-page archives",
      "count": 48
    },
    {
      "kind": "Rounding checks",
      "count": 12
    }
  ],
  "verification": "verified",
  "status": "live",
  "pricing": {
    "perCallPrice": 0.6
  },
  "publication": {
    "contentHash": "sha256:5b01c92a...9a21",
    "timestampAnchor": "opentimestamps:ots-5b01c92a2f77",
    "publishedAt": "2026-04-27T05:10:00Z"
  },
  "stake": {
    "activeStake": 1500
  }
}
Request Brief

A buyer-authored demand object specifying sector, geography, evidence types, expected lifecycle (Stream or Snapshot), verification level, and budget constraints.

{
  "id": "req-hk-weather-official-source",
  "slug": "hk-weather-official-source-apr27",
  "title": "Official Hong Kong weather source for Apr 27",
  "question": "Need official HKO high-temperature source capture, archive links, one-decimal reading, and rounding notes for today's daily weather market.",
  "sectorSlug": "weather-settlement",
  "topicSlugs": [
    "hk-weather-high-temp-settlement"
  ],
  "buyerHandle": "@weather_settle",
  "geography": "Hong Kong Observatory public source",
  "evidenceTypes": [
    "Official source",
    "Archive URL",
    "Rounding memo"
  ],
  "expectedMode": "stream",
  "verificationLevel": "verified",
  "budgetMin": 10,
  "budgetMax": 18,
  "deadline": "2026-04-27T18:00:00Z",
  "windowStart": "2026-04-27T00:00:00Z",
  "windowEnd": "2026-04-27T23:59:59Z",
  "status": "open",
  "publishedAt": "2026-04-27T04:30:00Z",
  "responseIds": []
}
Response Offer

A seller-authored response matching an open brief with match score, proposed summary, delivery ETA, and quoted price.

{
  "id": "resp-hormuz-1",
  "requestId": "req-hormuz-anomaly",
  "sellerId": "seller-euro-grid",
  "kind": "inventory",
  "matchScore": 0.94,
  "summary": "Direct match — our Hormuz Anomaly Cluster pack covers the same window with AIS + 2 satellite sources.",
  "etaHours": 1,
  "price": 14,
  "hasPreview": true,
  "status": "shortlisted"
}

Agent routing reads compatibility_level from AgentManifest — see Agent Interface.

Auth, rate limits and webhook subscriptions are out of scope for this preview.

Need the full surface?

This tab stays intentionally compact. The complete endpoint lookup now lives in the dedicated API Reference page.

Open API Reference
Next step

Integrate, read the mechanism, or inspect live inventory.

Building an agent? Pack-call settlement, disclosure profiles, and request routing live in /agent-spec. Want the node-capacity view? See /network.