api.stocktrends.com

Live 402 challenge

Captured by the enrichment pass, not read just now. Prices can change — always read the 402 the endpoint answers with.

{
  "error": "payment_required",
  "detail": "Payment is required to access this endpoint.",
  "pricing": {
    "unit": "request",
    "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "scheme": "exact",
    "network": "eip155:8453",
    "amount_usd": "0.250000"
  },
  "protocol": "x402",
  "resource": "https://api.stocktrends.com/v1/market/regime/history",
  "payment_required": {
    "accepts": [
      {
        "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "extra": {
          "name": "USD Coin",
          "version": "2",
          "resource": {
            "url": "https://api.stocktrends.com/v1/market/regime/history",
            "tags": [
              "finance",
              "equities",
              "market-regime",
              "regime-classification",
              "regime-history"
            ],
            "iconUrl": "https://developer.stocktrends.com/images/stmi-icon.png",
            "mimeType": "application/json",
            "description": "Historical sequence of weekly market regime classifications.",
            "serviceName": "Stock Trends Market Intelligence"
          }
        },
        "payTo": "0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab",
        "amount": "250000",
        "scheme": "exact",
        "network": "eip155:8453",
        "maxTimeoutSeconds": 300
      }
    ],
    "resource": {
      "url": "https://api.stocktrends.com/v1/market/regime/history",
      "tags": [
        "finance",
        "equities",
        "market-regime",
        "regime-classification",
        "regime-history"
      ],
      "iconUrl": "https://developer.stocktrends.com/images/stmi-icon.png",
      "mimeType": "application/json",
      "description": "Historical sequence of weekly market regime classifications.",
      "serviceName": "Stock Trends Market Intelligence"
    },
    "extensions": {
      "bazaar": {
        "info": {
          "role": "market_regime_classifier",
          "input": {
            "type": "http",
            "method": "GET",
            "queryParams": {
              "limit": 12
            }
          },
          "title": "Market Regime History",
          "family": "market",
          "output": {
            "type": "json",
            "format": "application/json",
            "example": {
              "request_id": "req_demo"
            }
          },
          "category": "market",
          "schemaUrl": "https://api.stocktrends.com/v1/ai/tools",
          "description": "Historical sequence of weekly market regime classifications.",
          "metadataUrl": "https://api.stocktrends.com/v1/ai/context",
          "tools_manifest": "https://api.stocktrends.com/v1/ai/tools",
          "pricing_catalog": "https://api.stocktrends.com/v1/pricing/catalog",
          "provenance_reference": {
            "semantic_continuity": "Stock Trends indicators use a consistent classification doctrine across decades of observations.",
            "interpretation_limit": "Historical depth supports research and probabilistic interpretation but does not guarantee future performance.",
            "full_metadata_endpoints": [
              "/v1/ai/context",
              "/v1/meta/indicators",
              "/v1/meta/stim"
            ],
            "classification_framework": "Stock Trends trend classification methodology",
            "approximate_observation_count": "16M+",
            "historical_coverage_start_year": 1980
          }
        },
        "schema": {
          "type": "object",
          "$schema": "https://json-schema.org/draft/2020-12/schema",
          "required": [
            "input"
          ],
          "properties": {
            "input": {
              "type": "object",
              "required": [
                "type",
                "method"
              ],
              "properties": {
                "type": {
                  "type": "string",
                  "const": "http"
                },
                "method": {
                  "enum": [
                    "GET"
                  ],
                  "type": "string"
                },
                "queryParams": {
                  "type": "object",
                  "required": [],
                  "properties": {
                    "limit": {
                      "type": "integer",
                      "default": 12,
                      "maximum": 52,
                      "minimum": 1
                    },
                    "start_date": {
                      "type": "string",
                      "format": "date"
                    }
                  },
                  "additionalProperties": false
                }
              },
              "additionalProperties": false
            },
            "title": {
              "type": "string"
            },
            "family": {
              "type": "string"
            },
            "output": {
              "type": "object",
              "required": [
                "type"
              ],
              "properties": {
                "type": {
                  "type": "string",
                  "const": "json"
                },
                "format": {
                  "type": "string"
                },
                "example": {}
              },
              "description": "Recent weekly market regime sequence.",
              "additionalProperties": true
            },
            "category": {
              "type": "string"
            },
            "schemaUrl": {
              "type": "string"
            },
            "description": {
              "type": "string"
            },
            "metadataUrl": {
              "type": "string"
            },
            "tools_manifest": {
              "type": "string"
            },
            "pricing_catalog": {
              "type": "string"
            }
          },
          "additionalProperties": true
        }
      }
    },
    "x402Version": 2
  },
  "stocktrends_preview": {
    "notes": [
      "Returns at most 52 weekly regime observations, most recent first.",
      "start_date sets the earliest eligible weekdate; it does not shift a window backwards into history. Combined with the 52-week ceiling, this endpoint covers recent regime history rather than an arbitrary research period.",
      "The applied_bounds block on the response reports the limit that was applied, the start_date in force, and whether the result was truncated.",
      "Each row uses the same classification logic as /v1/market/regime/latest."
    ],
    "pricing": {
      "unit": "request",
      "stc_cost": "0.250000",
      "cost_source": "/v1/pricing/catalog",
      "pricing_rule_id": "market_regime_history",
      "effective_price_usd": "0.250000"
    },
    "endpoint": {
      "path": "/v1/market/regime/history",
      "method": "GET",
      "purpose": "Review recent market regime transitions.",
      "category": "market",
      "access_type": "paid",
      "workflow_role": "Historical market context.",
      "requires_payment": true
    },
    "input_rule": null,
    "example_object": {
      "count": 1,
      "history": [
        {
          "regime": "mixed",
          "weekdate": "YYYY-MM-DD",
          "regime_score": 0
        }
      ]
    },
    "input_location": "query",
    "output_summary": "Recent weekly market regime sequence.",
    "response_shape": [
      "applied_bounds.start",
      "applied_bounds.end",
      "applied_bounds.window_source",
      "applied_bounds.default_window_weeks",
      "applied_bounds.limit",
      "applied_bounds.limit_source",
      "applied_bounds.max_limit",
      "applied_bounds.rows_returned",
      "applied_bounds.truncated_by_limit",
      "applied_bounds.widen_with",
      "history[].weekdate",
      "history[].regime",
      "history[].confidence",
      "history[].regime_score",
      "history[].bullish_pct",
      "history[].bearish_pct",
      "history[].avg_rsi",
      "history[].avg_mt_cnt",
      "history[].signal_count",
      "count",
      "limit",
      "start_date"
    ],
    "analytical_role": "market_regime_classifier",
    "optional_inputs": {
      "limit": {
        "type": "integer",
        "example": 12,
        "maximum": 52,
        "minimum": 1,
        "required": false,
        "description": "Maximum number of rows returned. This endpoint applies no default date window. The applied_bounds block on the response reports the limit that was actually used.",
        "safe_default": 12,
        "input_location": "query",
        "parameter_source": "query"
      },
      "start_date": {
        "type": "string",
        "format": "date",
        "example": "2025-01-03",
        "required": false,
        "description": "Optional earliest weekdate to include, in YYYY-MM-DD format. This filters which weeks are eligible; the endpoint still returns at most `limit` weeks and returns the most recent eligible weeks, so it does not select an arbitrary historical window.",
        "input_location": "query",
        "parameter_source": "query"
      }
    },
    "required_inputs": {},
    "supported_rails": [
      "subscription",
      "x402",
      "mpp"
    ],
    "parameter_source": "query",
    "related_endpoints": [
      "/v1/market/regime/latest",
      "/v1/market/regime/forecast"
    ],
    "evaluation_guidance": "Before deciding whether to acquire this data, inspect the task-relevant public capability (/.well-known/x402), interpretation, evidence, and pricing resources. Those are separate categories, availability is not evidence of usefulness, and none of them require payment. Full statement: /v1/ai/context (acquisition_evaluation_guidance).",
    "provenance_reference": {
      "semantic_continuity": "Stock Trends indicators use a consistent classification doctrine across decades of observations.",
      "interpretation_limit": "Historical depth supports research and probabilistic interpretation but does not guarantee future performance.",
      "full_metadata_endpoints": [
        "/v1/ai/context",
        "/v1/meta/indicators",
        "/v1/meta/stim"
      ],
      "classification_framework": "Stock Trends trend classification methodology",
      "approximate_observation_count": "16M+",
      "historical_coverage_start_year": 1980
    },
    "safe_example_request": {
      "path": "/v1/market/regime/history",
      "query": {
        "limit": 12
      },
      "method": "GET"
    },
    "investment_agent_value": "Helps agents understand whether current regime context is stable or changing.",
    "next_recommended_calls": [
      "/v1/market/regime/forecast"
    ],
    "interpretation_guidance": {
      "regime_score_scale": {
        "mixed": "-0.1 to 0.1",
        "range": [
          -1,
          1
        ],
        "formula": "bullish_pct - bearish_pct",
        "strong_bearish": "< -0.5",
        "strong_bullish": "> 0.5"
      },
      "downstream_workflow": "Use regime result to set bias in /v1/agent/screener/top or /v1/portfolio/construct. Confirm with /v1/breadth/sector/latest and /v1/leadership/summary/latest.",
      "interpretation_rules": [
        "regime_score = bullish_pct minus bearish_pct across all active trend signals.",
        "Do not use regime_score as a trade entry signal; use it as a portfolio bias input.",
        "avg_rsi > 100 indicates the average universe security outperforms the S&P 500 benchmark.",
        "avg_mt_cnt reveals whether the current regime is early-stage or mature.",
        "Confirm with /v1/market/regime/history before acting on a single regime reading."
      ],
      "confirmation_endpoints": [
        "/v1/breadth/sector/latest",
        "/v1/leadership/summary/latest"
      ]
    },
    "evaluation_guidance_source": "/v1/ai/context"
  },
  "accepted_payment_methods": [
    "subscription",
    "x402",
    "mpp"
  ]
}

Accepts

The payment requirements as published to the catalog. Read the live 402 before paying — a price here is a claim, not a quote.

[
  {
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "extra": {
      "name": "USD Coin",
      "version": "2"
    },
    "payTo": "0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab",
    "amount": "250000",
    "scheme": "exact",
    "network": "eip155:8453",
    "resource": "https://api.stocktrends.com/v1/market/regime/history",
    "maxTimeoutSeconds": 300
  }
]

Provenance

Seen in the source catalog

2026-09-24 00:26Z

Last indexed by Roundhouse

2026-09-24 11:15Z

Last enriched (probe, favicon, geo)

2026-09-16 17:15Z

x402 version

2

Max timeout

300s

Liveness probe

HTTP 402