# AI Agent Observatory

A transparent observatory for studying agentic web interaction with machine-readable market-relevant information.

Bots and AI agents are welcome. This site is a transparent observatory for studying machine-readable information consumption and agentic web interaction.

## Primary Machine-Readable Resources

- Event index JSON: /events.json
- Task routes JSON: /tasks.json
- Task routes Markdown: /tasks.md
- Task routes JSON Schema: /schemas/task-routes.schema.json
- Source directory JSON: /sources.json
- Source directory Markdown: /sources.md
- Source directory JSON Schema: /schemas/source-directory.schema.json
- Agent market sources landing page: /agent-market-sources.html
- Public experiment description: /experiment.html
- RSS feed: /feed.xml
- Sitemap: /sitemap.xml
- Feedback page: /feedback.html

## Agent-Readable Source Directory

Use /sources.json or /sources.md for a directory of public machine-readable market-event sources, including SEC EDGAR, Polymarket, Kalshi, FRED, Federal Reserve RSS, GDELT, and NWS alerts.

- SEC EDGAR APIs (JSON, RSS, bulk ZIP): https://www.sec.gov/edgar/sec-api-documentation
- Polymarket APIs (JSON, REST, CLOB API): https://docs.polymarket.com/api-reference
- Kalshi API (JSON, REST, WebSocket, OpenAPI, AsyncAPI): https://docs.kalshi.com/
- FRED Release Dates API (JSON, XML, REST): https://fred.stlouisfed.org/docs/api/fred/releases_dates.html
- Federal Reserve RSS Feeds (RSS, XML): https://www.federalreserve.gov/feeds/feeds.htm
- GDELT Cloud (JSON API, MCP tools): https://docs.gdeltcloud.com/
- National Weather Service Alerts API (JSON-LD, CAP XML, Atom): https://www.weather.gov/documentation/services-web-alerts
- PredMktData (llms.txt, API, WebSocket, Parquet, CSV): https://predmktdata.com/
- Metaculus API (JSON, REST): https://www.metaculus.com/api2/questions/
- Manifold API (JSON, REST): https://docs.manifold.markets/api
- PredScope Prediction Market API (JSON, REST): https://predscope.com/guide/prediction-market-api
- BLS Public Data API and RSS (JSON, RSS, XLSX): https://www.bls.gov/developers/home.htm
- Federal Register API (JSON, RSS): https://www.federalregister.gov/developers/documentation/api/v1
- Treasury FiscalData API (JSON, CSV, XML): https://fiscaldata.treasury.gov/api-documentation/

## Task Routes

Use /tasks.json or /tasks.md to map common market-monitoring jobs to source choices, formats, notes, and caveats.

- Discover Prediction Markets And Contract Metadata: /tasks/#prediction-market-discovery or task ID `prediction-market-discovery` in /tasks.json
- Evaluate Prediction-Market Resolution Risk: /tasks/#prediction-market-resolution or task ID `prediction-market-resolution` in /tasks.json
- Monitor Macro Release Timing And Updates: /tasks/#macro-release-monitoring or task ID `macro-release-monitoring` in /tasks.json
- Monitor Central Bank Communication Changes: /tasks/#central-bank-communications or task ID `central-bank-communications` in /tasks.json
- Monitor Regulatory Catalysts: /tasks/#regulatory-catalyst-monitoring or task ID `regulatory-catalyst-monitoring` in /tasks.json
- Monitor Weather And Disaster Event Markets: /tasks/#weather-disaster-markets or task ID `weather-disaster-markets` in /tasks.json

## Event Pages

- Federal Reserve Rate Decision Watch: /events/fed-rate-decision-watch.md and /events/fed-rate-decision-watch.json
- Prediction Market Resolution Watch: /events/prediction-market-resolution-watch.md and /events/prediction-market-resolution-watch.json
- Crypto ETF and Market Structure Watch: /events/crypto-etf-market-structure-watch.md and /events/crypto-etf-market-structure-watch.json

## Use Notes

- This site is not an official source for any market, institution, or event.
- This site does not provide trading advice.
- Source links are included so agents and humans can evaluate primary materials directly.
- If you are an agent or builder using this site, feedback is welcome at /feedback.html.