# TradeOS Forecast Path Context

> TradeOS Forecast Path Context is a paid API for AI agents from tradeos.tech, paid per call via x402, $0.45/call, status unknown (last checked 2026-09-13).

Returns explanation of a crypto forecast's target zone and multi-day realization context for a given token or signal.

## Facts

- Endpoint: POST https://tradeos.tech/x402/v1/intelligence/tradeos-forecast-path-context
- Price: $0.45/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tradeos-tech-62b80c58
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Fir-8JbHPFKq_fSoJoIgq

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability tradeos-tech-62b80c58 -d '<json body>'
```

Example prompt: Can you pull the TradeOS forecast path context for ETH — I want to understand the target-zone explanation and the multi-day realization context behind its current signal?

## When to prefer this

Use this endpoint when you need to understand the reasoning and multi-day realization path behind a specific crypto forecast target zone, as opposed to just the signal itself. Prefer this over the general intelligence endpoint when the user specifically wants forecast explanation and path context rather than a broad market snapshot or new signal discovery.

## Known failure modes

- Unknown token symbol or contract returns a 404 or empty result
- Stale or unavailable forecast data returns a freshness warning
- Invalid signal ID returns a validation error
- Payment not settled via x402 returns a 402 Payment Required
- Malformed request body returns a 400 Bad Request

## Output

A JSON object containing the target-zone explanation for the specified token or signal, along with multi-day realization context, forecast path rationale, supporting reasons, and freshness metadata — all read-only research output with no trade instructions.

## Example request

```json
{
 "input": {
  "body": {
   "output": "json",
   "symbol": "ETH",
   "chain_id": "1",
   "metadata": {
    "request_type": "path_context"
   }
  },
  "type": "http",
  "method": "POST",
  "bodyType": "json"
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "properties": {
      "output": {
       "type": "string"
      },
      "symbol": {
       "type": "string"
      },
      "chain_id": {
       "type": "string"
      },
      "metadata": {
       "type": "object"
      },
      "contract_address": {
       "type": "string"
      }
     },
     "additionalProperties": true
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "type": "string",
     "const": "POST"
    },
    "bodyType": {
     "type": "string",
     "const": "json"
    }
   }
  },
  "output": {
   "type": "object"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "details",
  "drivers",
  "notices",
  "service",
  "subject",
  "verdict",
  "evidence",
  "confidence",
  "created_at",
  "request_id",
  "risk_flags",
  "next_checks",
  "missing_data",
  "request_type",
  "response_mode",
  "data_freshness",
  "negative_drivers",
  "positive_drivers",
  "refusal_category"
 ],
 "properties": {
  "details": {
   "type": "object",
   "required": [
    "forecast",
    "human_summary",
    "lookback_days",
    "forecast_bound",
    "interpretation",
    "realization_windows",
    "source_availability"
   ],
   "properties": {
    "forecast": {
     "type": "object",
     "required": [
      "available",
      "unavailable_reason"
     ],
     "properties": {
      "available": {
       "type": "boolean"
      },
      "unavailable_reason": {
       "type": "string"
      }
     }
    },
    "human_summary": {
     "type": "object",
     "required": [
      "headline",
      "data_gaps",
      "builder_use",
      "score_notes",
      "verdict_label",
      "thesis_tracking",
      "product_primitive",
      "what_needs_review",
      "realization_windows",
      "target_zone_context",
      "what_is_constructive",
      "selected_route_reason",
      "plain_language_summary"
     ],
     "properties": {
      "headline": {
       "type": "string"
      },
      "data_gaps": {
       "type": "array",
       "items": {
        "type": "string"
       }
      },
      "builder_use": {
       "type": "string"
      },
      "score_notes": {
       "type": "array",
       "items": {
        "type": "string"
       }
      },
      "verdict_label": {
       "type": "string"
      },
      "thesis_tracking": {
       "type": "object",
       "required": [
        "recheck_cadence",
        "continuous_use_note"
       ],
       "properties": {
        "recheck_cadence": {
         "type": "string"
        },
        "continuous_use_note": {
         "type": "string"
        }
       }
      },
      "product_primitive": {
       "type": "string"
      },
      "what_needs_review": {
       "type": "array",
       "items": {
        "type": "string"
       }
      },
      "realization_windows": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "window",
         "samples"
        ],
        "properties": {
         "window": {
          "type": "string"
         },
         "samples": {
          "type": "number"
         }
        }
       }

… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tradeos-tech-62b80c58/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tradeos.tech](https://www.zero.xyz/host/tradeos.tech/llms.txt)