# Precog Markets — Agent and Integrator Guide

> Precog is an open-source prediction market protocol on Base (8453) and Arbitrum (42161). Users trade outcome shares in ERC20-collateralized markets, create markets, fund launchpad proposals, and resolve outcomes via on-chain oracles.

## What this site is

Precog Markets (`https://core.precog.markets`) is the primary web application. It proxies a public REST API at `/api/v1/*` to the Precog tracker backend (`https://tracker.precog.markets/api/v1`). Most read endpoints are public. Some user-specific write endpoints require a Privy bearer token.

## Canonical discovery entry points

Start here for machine discovery:

1. `/.well-known/agents/index.json` — primary agent discovery index
2. `/.well-known/agent-skills/index.json` — Agent Skills protocol index
3. `/.well-known/ai-catalog.json` — all discovery resources in one JSON catalog
4. `/llms.txt` and `/.well-known/llms.txt` — curated human/agent site map
5. `/.well-known/api-catalog` — RFC 9727 API linkset anchored at `/api/v1`
6. `/openapi.json` — OpenAPI 3.1 description of public routes

## Public API (read-mostly)

Base URL: `https://core.precog.markets/api/v1`

Common GET endpoints:

- `/markets?chain_id={chainId}` — list live markets
- `/upcoming-markets?chain_id={chainId}` — list launchpad markets
- `/market-prices` — current share prices
- `/market-trades` — recent trades
- `/player-scores` — leaderboard scores
- `/referral-scores` — referral leaderboard
- `/sentiment-market-scores` — sentiment leaderboard

Authenticated routes (Privy bearer token) include account updates and some action endpoints. Machine OAuth (`/oauth/token`) is planned; see `/.well-known/oauth-protected-resource`.

## Agent protocols supported

### A2A

- Agent card: `/.well-known/agent-card.json`
- Declares skills such as list-markets, read-market-prices, and WebMCP navigation helpers
- Programmatic interface: `/api/v1` (HTTP JSON)

### MCP

- Server card: `/.well-known/mcp/server-card.json`
- HTTP transport stub: `/mcp` (returns 501 — not a live MCP server yet)
- In-browser WebMCP tools are registered at page load via `navigator.modelContext`

### OAuth / OIDC (discovery only)

- `/.well-known/oauth-authorization-server`
- `/.well-known/openid-configuration`
- `/.well-known/oauth-protected-resource` (site-level)
- `/.well-known/oauth-protected-resource/api/v1` (API resource per RFC 9728)
- `/.well-known/jwks.json`

## Networks

- Base mainnet: chain ID `8453`, markets at `/8453/{marketId}`
- Arbitrum One: chain ID `42161`, markets at `/42161/{marketId}`
- Launchpad: `/launchpad/{chainId}`

## Human documentation

- Learn: https://learn.precog.markets/
- Developer docs: https://docs.precog.markets/

## Contact and security

- Security disclosures: `/.well-known/security.txt`
- Community: https://discord.gg/frgXQfM3KZ
- Source: https://github.com/precog-core