{"version":"2026-04-24","generated_for":"TRADING4AI public sample discovery","core_machine_links":[{"label":"/llms","href":"/llms","summary":"Machine bridge page for discovery, entry selection, and access boundaries."},{"label":"/llms.txt","href":"/llms.txt","summary":"Compact plain-text discovery layer for crawlers, LLMs, and agents."},{"label":"/artifact-samples/README.md","href":"/artifact-samples/README.md","summary":"Plain-text raw package directory guide for the artifact sample-file namespace."},{"label":"/openapi.json","href":"/openapi.json","summary":"Canonical runtime API contract."},{"label":"/.well-known/agent.json","href":"/.well-known/agent.json","summary":"Agent entry point index."},{"label":"/for-agents","href":"/for-agents","summary":"Human-readable integration guide for the machine surface."},{"label":"/human","href":"/human","summary":"Human-oriented service layer for positioning, pricing, orders, and delivery."}],"category":{"slug":"artifacts","title":"Artifact Samples","summary":"Public artifact package samples with HTML landing pages and raw sample files.","landing_page":"/samples/artifacts","raw_landing_page":"/examples/artifacts","markdown_guide":"/examples/artifacts/README.md","raw_package_guide":"/artifact-samples/README.md","json_catalog":"/examples/artifacts/index.json","entries":[{"slug":"eth-breakout-playbook","title":"ETH Breakout Playbook","html_page":"/samples/artifacts/eth-breakout-playbook","raw_files":["/artifact-samples/eth-breakout-playbook/manifest.json","/artifact-samples/eth-breakout-playbook/README.md","/artifact-samples/eth-breakout-playbook/examples.json","/artifact-samples/eth-breakout-playbook/reference_strategy.py"]},{"slug":"btc-trap-playbook","title":"BTC Trap Playbook","html_page":"/samples/artifacts/btc-trap-playbook","raw_files":["/artifact-samples/btc-trap-playbook/manifest.json","/artifact-samples/btc-trap-playbook/README.md","/artifact-samples/btc-trap-playbook/examples.json","/artifact-samples/btc-trap-playbook/reference_strategy.py"]}]},"machine_index":{"html_page":"/samples","raw_example_hub":"/examples","markdown_guide":"/examples/README.md","json_catalog":"/examples/index.json","raw_package_guide":"/artifact-samples/README.md"},"entry_selector":[{"audience":"Crawler or search engine","start_with":"/samples","why":"Use the HTML sample hub first because it contains crawlable explanations, internal links, and structured data."},{"audience":"LLM or agent needing compact discovery","start_with":"/examples/index.json","why":"Use the JSON catalog when the caller needs categories, recommended paths, and direct raw-file links without parsing HTML."},{"audience":"LLM needing plain text context","start_with":"/examples/README.md","why":"Use the Markdown guide when a compact plain-text explanation is easier to ingest than page markup."},{"audience":"Machine needing artifact package browsing","start_with":"/artifact-samples/README.md","why":"Use the raw package guide when the artifact package-file namespace itself matters more than the wider category overview."},{"audience":"Agent runtime or tool caller","start_with":"/.well-known/agent.json","why":"Use the machine-readable entry-point index before choosing narrative guides or the canonical API contract."},{"audience":"Human operator or buyer","start_with":"/human","why":"Use the human site for service positioning, pricing, order flow, and delivery expectations."}],"machine_use_checklist":[{"label":"Use HTML for explanation","guidance":"Read /samples and its child pages when you need narrative context, field explanations, internal links, and structured data."},{"label":"Use JSON for discovery","guidance":"Fetch /examples/index.json when you need a compact catalog of categories, recommended paths, raw files, and entry selectors."},{"label":"Use Markdown for plain-text ingestion","guidance":"Fetch /examples/README.md when you need a compact text guide that is easy for LLM retrieval or summarization."},{"label":"Use agent entry points for runtime discovery","guidance":"Fetch /.well-known/agent.json when a tool caller or agent runtime needs the machine-readable entry-point index before choosing routes."},{"label":"Use /for-agents for narrative machine guidance","guidance":"Read /for-agents when the integration needs runtime posture, access-boundary explanation, or a human-readable walkthrough of the machine surface."},{"label":"Use raw package guides for artifact directory browsing","guidance":"Fetch /artifact-samples/README.md when you need the artifact package-file namespace itself, rather than the wider category-level discovery guide."},{"label":"Use raw files for exact payloads","guidance":"Fetch /examples/quant-lab/*.json, /examples/delivery/*.json, or /artifact-samples/* files when you need exact public example content."},{"label":"Do not treat samples as entitlements","guidance":"Public sample links do not unlock private paid bundles; private delivery still requires claim, entitlement, and access-token checks."},{"label":"Use OpenAPI for the contract","guidance":"Treat /openapi.json as the canonical API contract; sample files illustrate common payloads but do not replace the contract."}],"recommended_paths":[{"slug":"artifact-delivery-boundary","title":"Artifact and delivery boundary","summary":"Recommended reading order for understanding sample package structure and the private delivery boundary.","steps":[{"label":"Sample hub","href":"/samples"},{"label":"Artifact samples","href":"/samples/artifacts"},{"label":"ETH artifact sample","href":"/samples/artifacts/eth-breakout-playbook"},{"label":"Artifact raw package guide","href":"/artifact-samples/README.md"},{"label":"Delivery sample","href":"/samples/delivery/quant-lab-standard"},{"label":"Raw example hub","href":"/examples"}]},{"slug":"artifact-raw-discovery","title":"Artifact raw discovery","summary":"Recommended reading order for machines that want the raw artifact-side discovery layer first.","steps":[{"label":"Raw example hub","href":"/examples"},{"label":"Artifact raw landing page","href":"/examples/artifacts"},{"label":"Artifact JSON catalog","href":"/examples/artifacts/index.json"},{"label":"Artifact Markdown guide","href":"/examples/artifacts/README.md"},{"label":"Artifact raw package guide","href":"/artifact-samples/README.md"},{"label":"ETH artifact sample page","href":"/samples/artifacts/eth-breakout-playbook"}]}],"faq":[{"question":"Are public samples the same as private paid bundles?","answer":"No. Public samples are safe, indexable examples that explain request shapes, response shapes, artifact structure, and delivery boundaries. Private paid bundles remain behind Worker authorization, claim tokens, entitlement state, and access tokens."},{"question":"Which entry should an LLM or agent fetch first?","answer":"Use /examples/index.json for compact machine-readable discovery. Use /examples/README.md when plain-text context is easier to ingest. Use /artifact-samples/README.md when the artifact package-file namespace itself matters. Use /samples when explanatory HTML and internal links are useful."},{"question":"When should a machine use /artifact-samples/README.md?","answer":"Use /artifact-samples/README.md when the machine needs the artifact package-file namespace itself, rather than the wider category-level discovery layer documented under /examples/artifacts/README.md."},{"question":"Are the raw JSON files the canonical API contract?","answer":"No. The raw JSON files are examples. The canonical API contract remains /openapi.json, while /llms and llms.txt provide discovery and orientation."},{"question":"Do these samples create real Quant Lab jobs or orders?","answer":"No. The samples demonstrate structure only. Real Quant Lab requests, orders, payment verification, and delivery access require the live API flow."},{"question":"How should a machine understand private delivery access?","answer":"Treat the public pages and raw files as documentation. Real private files require the order, claim, entitlement, and access-token flow documented in the API and /for-agents."}]}