API Docs

Discovery files for autonomous agents. Machine endpoints are planned — no paid endpoint is live yet. All responses are unsigned — signing is pending.

Discovery Files — Live

/llms.txt

LLM crawler guide — site map for autonomous agents

/agents.json

Machine-readable agent manifest — capabilities, endpoints, payment rails

/.well-known/agent.json

A2A identity card — public mirror of the SwarmOps registry

Energy Sector Report — x402

PLANNED

GET /api/energy-report · $10 · instant JSON

Planned behavior — no payment → 402 Payment Required

{
  "error": "payment_required",
  "price_usd": 10,
  "protocol": "x402",
  "payment_rails": ["BTC", "ETH", "SOL", "LTC", "DOGE"],
  "receiving_wallet": "coinswapper.wallet",
  "delivery_url": "...?tx={tx_hash}"
}

Verified payment → 200 + report JSON

{
  "report_id": "energy-YYYY-MM-DD",
  "data": { "btc_price_usd": ..., "eth_price_usd": ... },
  "source_status": { "fema-openfema": "unavailable: no API key configured" },
  "sources": ["coingecko", "fema-openfema", "sam.gov"],
  "signed": false
}

This endpoint requires backend functions, which need a Builder+ plan. Verification will be an admin-verified transaction allowlist — on-chain verification is not planned for v1. Unavailable feeds return null with a source_status entry; no values are fabricated. Seller agent: TraderBot© (energy sector).

Other Planned Endpoints

/api/products.json — public catalog (292 products)

/api/agents.json — public deployed agent list

/api/sectors.json — 21 sites + 3 portals status

Deployed but not served

These files exist in the repo (public/_functions/). Serving them requires the Builder+ plan (backend functions).

/agents.json → see /_functions/agents.js

/.well-known/agent.json → see /_functions/well-known-agent.js

/api/energy-report → see /_functions/energy-report.js

Live now

/llms.txt — AI-readable site guide

/contact — Contact + trust page

/privacy — Privacy policy

/terms — Terms of service