# TRADING4AI Secondary Quant Lab Public Examples

This directory contains secondary Quant Lab examples for older request creation, request status, and budget-confirm payload shapes.

Current reliability materials live at `/agent-verification/materials`; this category is secondary reference.

These files are examples only. They do not create real jobs, approve budgets, run backtests, or unlock protected delivery.

## Primary Entry Points

- Current reliability materials: https://trading4ai.com/agent-verification/materials
- Category HTML landing: https://trading4ai.com/samples/quant-lab
- Category raw landing: https://trading4ai.com/examples/quant-lab
- Category JSON catalog: https://trading4ai.com/examples/quant-lab/index.json
- Category Markdown guide: https://trading4ai.com/examples/quant-lab/README.md
- Top-level JSON catalog: https://trading4ai.com/examples/index.json
- Top-level Markdown guide: https://trading4ai.com/examples/README.md
- Machine bridge: https://trading4ai.com/llms
- Agent entry point: https://trading4ai.com/.well-known/agent.json
- Legacy runtime snapshot: https://trading4ai.com/openapi.json

## Files

- `/samples`
- `/examples`
- `/examples/README.md`
- `/samples/quant-lab`
- `/examples/quant-lab`
- `/examples/quant-lab/index.json`
- `/examples/quant-lab/README.md`
- `/examples/quant-lab/request-create.json`
- `/examples/quant-lab/request-status.json`
- `/examples/quant-lab/budget-confirm.json`
- `/examples/index.json`
- `/llms.txt`
- `/llms`
- `/.well-known/agent.json`
- `/for-agents`
- `/openapi.json`

## Recommended Flow

1. Start with `/agent-verification/materials` for current agent-facing reliability work.
2. Start with `/samples` when you want the top-level HTML public sample hub.
3. Read `/examples` when you want the top-level raw example hub and shared machine entry points.
4. Read the HTML overview at `/samples/quant-lab`.
5. Read `/examples/quant-lab` when you want the raw category landing page with discovery guidance.
6. Inspect `/samples/quant-lab/request-create` to understand intake shape.
7. Inspect `/samples/quant-lab/request-status` to understand sample state shape.
8. Inspect `/samples/quant-lab/budget-confirm` to understand the older budget-confirm sample.
9. Fetch `/examples/quant-lab/index.json` if you need the category-level machine-readable catalog.

## Which Entry Should You Start With?

- Crawler or search engine: start with `/samples/quant-lab` when this secondary archive is needed.
- LLM or agent needing compact discovery: start with `/examples/quant-lab/index.json`.
- LLM needing plain text context: start with `/examples/quant-lab/README.md`.
- Tool caller: start with `/.well-known/agent.json`, then use `/llms.txt` and `/for-agents` for static discovery and access-boundary guidance.
- Current reliability task: start with `/agent-verification/materials`, not this sample archive.

## Important Fields

- `template_id`: selected sample workflow.
- `template_parameters`: schema-shaped parameters for the selected sample workflow.
- `request_token`: demo follow-up token field used by the sample status or budget shapes.
- `request_urls`: direct follow-up links shown by the sample payload.
- `next_actions`: machine hint for whether clarification or budget confirmation is represented in the sample.
- `execution_outcome`: normalized result shape used by older examples.

## Boundary

No live request, order, payment, entitlement, or delivery flow is implied by these public examples.

These examples show public payload shape and state transitions only. They are secondary references for older Quant Lab structures and should not be treated as current reliability deliverables.

Use `/openapi.json` only when intentionally reviewing the legacy runtime snapshot.

For current Pages-only public work, use `/agent-verification/materials`, `/llms.txt`, and `/.well-known/agent.json`.