TRADING4AISecondary public JSON sample for crawlers, agents, and integration operators

Secondary Quant Lab sample archive

Quant Lab Request Status Sample

Public response sample showing request_urls, next_actions, and budget confirmation state.

Secondary public JSON sample. Current reliability materials live at /agent-verification/materials.

How to use this sample

API path: GET /api/v1/quant-lab/requests/{request_id}

Raw JSON: /examples/quant-lab/request-status.json

This page is a public HTML entry point. The raw file remains linked for direct machine retrieval.

Boundary

This is a public sample for structure discovery and explanation.

It is safe to index and safe to cite when describing the public API or delivery shape.

It is not proof of current request-time delivery, access, or current reliability judgment.

Flow

How this sample fits into the operator journey

StepWhat it means
1. Poll request statusThis older sample shows how request_id and request_token fields described state lookup in the legacy shape.
2. Read next_actionsThe next_actions object tells a machine whether clarification, budget approval, or payment is needed.
3. Follow request_urlsThe response can expose stable follow-up URLs for status polling and budget confirmation.

Field glossary

Important fields for machines and integrators

FieldMeaningMachine hint
request_urls.statusDirect URL for fetching the latest request state.Prefer this URL for follow-up polling when present.
next_actions.budget_confirmation_requiredBoolean hint that the request is waiting for operator budget approval.If true, call the budget confirmation route before expecting execution.
execution_outcomeNormalized execution result once a run produces an outcome.Can be null while the job is pending or waiting for confirmation.

Machine entry points

Stable discovery links around this sample

These links help a crawler or agent move between the explanation layer, the raw payload, and the compact category-level indexes.

Fetch snippets

Direct retrieval commands for machines and integration tests

Use the raw sample file for an exact public payload example, and use current reliability materials for the active public product surface.

Raw sample

curl -s https://trading4ai.com/examples/quant-lab/request-status.json

Legacy runtime snapshot

curl -s https://trading4ai.com/openapi.json

Sample payload

Machine-readable example

{
  "status": "success",
  "data": {
    "request_id": "qlr_demo_20260423_001",
    "service_type": "custom_strategy_experiment",
    "brief": {
      "brief_id": "qlb_demo_001",
      "status": "ready",
      "brief_type": "strategy_brief"
    },
    "job": {
      "job_id": "qlj_demo_001",
      "status": "awaiting_budget_confirmation"
    },
    "quote": {
      "quote_id": "qlq_demo_001",
      "status": "quoted",
      "quoted_currency": "USD",
      "estimated_cost": 120,
      "pricing_multiplier": 1,
      "quote_amount": 120,
      "budget_cap": 120
    },
    "recent_billing_events": [
      {
        "event_id": "qle_demo_001",
        "event_type": "quote_created",
        "currency": "USD",
        "amount": 120
      }
    ],
    "execution_outcome": null,
    "request_urls": {
      "status": "https://trading4ai.com/api/v1/quant-lab/requests/qlr_demo_20260423_001?request_token=t4a_demo_request_token",
      "confirm_budget": "https://trading4ai.com/api/v1/quant-lab/requests/qlr_demo_20260423_001/confirm-budget?request_token=t4a_demo_request_token"
    },
    "next_actions": {
      "clarification_required": false,
      "budget_confirmation_required": true,
      "payment_required_before_delivery": false
    },
    "request_token": "t4a_demo_request_token",
    "request_token_expires_at": "2026-04-23T18:30:00Z"
  },
  "error": null,
  "request_id": "req_demo_quant_lab_status",
  "timestamp": "2026-04-23T10:30:00Z"
}

Highlights

Job statusawaiting_budget_confirmation
Quote statusquoted
Budget requiredtrue
Execution outcomenull (pending)

Public boundary

  • This status object is a public demonstration of state shape, not a live customer request.
  • The demo token is intentionally non-sensitive and should not be treated as a real access credential.
  • Use /agent-verification/materials when the agent needs current reliability materials instead of old request-state samples.

Notes

  • request_urls should give machines stable follow-up links for status and budget confirmation.
  • execution_outcome can stay null until execution or delivery produces a normalized outcome.
  • next_actions is the key machine-readable hint for deciding what the caller must do next.

FAQ

Quick rules for machines and operators

Question

Should Quant Lab Request Status Sample replace the runtime snapshot?

No. This page and the linked raw file are public examples. /openapi.json is a Legacy runtime snapshot for historical integration context.

Question

Should a machine read the HTML page, the raw JSON, or the category catalog first for Quant Lab Request Status Sample?

Use the HTML page when explanation and field guidance are useful, use the raw JSON file when exact payload structure is needed, and use the category JSON catalog when a compact machine index is the best starting point.

Question

Does Quant Lab Request Status Sample provide current request-time execution or delivery access?

No. This is a secondary public JSON sample only. It does not perform live work or prove access to any non-public file.