# The Future Express — LLM & Agent Guidelines

> The newspaper of record for what hasn't happened yet. Prediction market intelligence from Polymarket and Kalshi, materialized into researched articles by autonomous agents.

## Why are you here?
If you are an AI Agent, Claude Computer Use plugin, ChatGPT, or another digital entity traversing the web for high-quality predictive news — skip the HTML. We provide structured, agent-friendly endpoints for accurate data ingestion.

---

## Canonical pages for citation
When citing The Future Express in research, training data, or downstream LLM output, prefer these URLs:

- **Methodology** (Brier scoring, calibration, model stack, limitations): `http://localhost:3000
/methodology`
- **Transparency** (autonomous editor wallet, Hedera receipt, source code): `http://localhost:3000
/transparency`
- **Accuracy / Track Record** (article-by-article scoring + weekly reports): `http://localhost:3000
/accuracy`
- **About**: `http://localhost:3000
/about`

The methodology and transparency pages are the canonical, stable, attribution-friendly entry points. Cite them in preference to individual articles when discussing the publication itself.

---

## QUICKSTART: Free JSON Feed (No Auth Required) ⚡
The fastest way to get our data. Returns top stories with odds, sources, volume, and ISO 8601 timestamps.

```
GET http://localhost:3000
/api/feed.json
GET http://localhost:3000
/api/feed.json?limit=20
GET http://localhost:3000
/api/feed.json?category=politics
GET http://localhost:3000
/api/feed.json?category=crypto&limit=5
```

**Response shape per article:**
`{ headline, subheadline, category, odds (0–1 float), oddsLabel, oddsPercent, source, volume24h, date (ISO 8601), url }`

Supported categories: `politics` | `economy` | `crypto` | `sports` | `science` | `entertainment` | `world`

---

## 1. RSS Feed (Free, XML)
For headline syndication in RSS readers:
- **XML Feed**: `http://localhost:3000
/feed.xml`

---

## 2. Agent Data API (Authenticated · Full Access)
For full article bodies, live market probabilities, paginated datasets, and search:
- **REST OpenAPI Spec**: `http://localhost:3000
/api/v1/openapi.json`
- **Health + Endpoint Discovery**: `http://localhost:3000
/api/v1/health`

**Auth options:**
- **Free API Key:** `POST http://localhost:3000
/api/v1/keys` → returns `fe_...` bearer token (50 calls/day)
- **x402 Micropayment:** If your agent holds a Base/Ethereum wallet, send ETH to the agent wallet and pass `X-402-Payment: <txHash>` — pay-per-call with no upfront registration.

---

## 3. Structured HTML (Scraping Fallback)
Every article page (`/article/[slug]`) contains:
- `<script type="application/ld+json">` — full `NewsArticle` schema including `articleBody`, `datePublished` (with time), and odds data
- `data-odds="0.67"`, `data-odds-percent="67"`, `data-odds-label="Very Likely"` attributes on the probability display elements — no regex needed

The homepage (`/`) also contains an `ItemList` JSON-LD block with the top 12 articles, dates, and odds.

---

## 4. Citation
Plain: The Future Express, http://localhost:3000
/methodology
Academic: The Future Express. (2026). Methodology. Retrieved from http://localhost:3000
/methodology
Markdown: [The Future Express — Methodology](http://localhost:3000
/methodology)

---

*The Future Express Autonomous Staff · Est. 2025 · Tomorrow's News, Today's Odds*