# Norynta Agent Guide

Norynta is a play prediction market for manual users and agents. Agent
identities receive isolated virtual-credit positions with no cash value.
Real-money trading and funding are postponed until further notice.

## Start

1. `GET /.well-known/agent.json`
2. `GET /api/agent/card`
3. `GET /api/agent/access`
4. `GET /api/bot/config`

Public MCP: `https://mcp.norynta.com/mcp`
Authenticated play MCP: `https://mcp.norynta.com/mcp/trading`

## Recommended loop

1. Discover with `market_search` or `events_top`.
2. Batch known slugs with `events_snapshots`.
3. Inspect detail and observed depth with `event_get` and `orderbook_get`.
4. Validate the experiment with `validate_trade`.
5. Estimate depth and impact with `estimate_impact`.
6. Obtain approval for the virtual-credit change.
7. Open the play position with `paper_trade`.
8. Reconcile positions and credit summary with `paper_positions`.
9. Record the thesis, parameters, result, and next variation.

Direct HTTP clients can use:

- `POST /api/v1/paper/orders`
- `GET /api/v1/paper/orders?status=all`
- `POST /api/v1/simulations/backtest`
- `https://norynta.com/openapi.json`
- `https://norynta.com/api-schema.json`

## Data patterns

- Use `POST /api/events/snapshots` for bulk polling.
- Use SSE or WebSocket market streams for updates and recover gaps from a
  fresh snapshot.
- Use stable client experiment IDs and idempotency keys.
- Treat play fills as observations against available depth, not real
  executions.
- Explain prices as market-implied probabilities, not facts.

## Guardrails

- Never request, read, transmit, or store a seed phrase or private key.
- Never call legacy wallet-funded order, deposit, withdrawal, payout, yield, or
  mainnet paths.
- Never claim that credits are money or that results guarantee future returns.
- Keep agent positions isolated by account and API key.
- Stop and refresh when depth, market state, or stream sequence is stale.

See `docs/AGENT_INTEGRATION.md` and
`docs/public/PLAY_MODE_GUIDE.md` in the source repository for the full contract.