Stock Trends Market Intelligence

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.300000"
  },
  "protocol": "x402",
  "resource": "https://api.stocktrends.com/v1/leadership/rotation/history",
  "payment_required": {
    "accepts": [
      {
        "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "extra": {
          "name": "USD Coin",
          "version": "2",
          "resource": {
            "url": "https://api.stocktrends.com/v1/leadership/rotation/history",
            "tags": [
              "finance",
              "equities",
              "sector-rotation",
              "market-leadership",
              "rotation-history"
            ],
            "iconUrl": "https://developer.stocktrends.com/images/stmi-icon.png",
            "mimeType": "application/json",
            "description": "Historical sector leadership rotation derived from Stock Trends trend distribution, relative performance, and trend maturity measures.",
            "serviceName": "Stock Trends Market Intelligence"
          }
        },
        "payTo": "0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab",
        "amount": "300000",
        "scheme": "exact",
        "network": "eip155:8453",
        "maxTimeoutSeconds": 300
      }
    ],
    "resource": {
      "url": "https://api.stocktrends.com/v1/leadership/rotation/history",
      "tags": [
        "finance",
        "equities",
        "sector-rotation",
        "market-leadership",
        "rotation-history"
      ],
      "iconUrl": "https://developer.stocktrends.com/images/stmi-icon.png",
      "mimeType": "application/json",
      "description": "Historical sector leadership rotation derived from Stock Trends trend distribution, relative performance, and trend maturity measures.",
      "serviceName": "Stock Trends Market Intelligence"
    },
    "extensions": {
      "bazaar": {
        "info": {
          "role": "leadership_intelligence",
          "input": {
            "type": "http",
            "method": "GET",
            "queryParams": {
              "type": "CS",
              "top_k": 5,
              "exchange": "N",
              "group_by_week": true
            }
          },
          "title": "Leadership Rotation History",
          "family": "leadership",
          "output": {
            "type": "json",
            "format": "application/json",
            "example": {
              "request_id": "req_demo"
            }
          },
          "category": "leadership",
          "schemaUrl": "https://api.stocktrends.com/v1/ai/tools",
          "description": "Historical sector leadership rotation derived from Stock Trends trend distribution, relative performance, and trend maturity measures.",
          "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": {
                    "end": {
                      "type": "string",
                      "format": "date"
                    },
                    "type": {
                      "type": "string",
                      "default": "CS"
                    },
                    "limit": {
                      "type": "integer",
                      "default": 2000,
                      "maximum": 50000,
                      "minimum": 1
                    },
                    "start": {
                      "type": "string",
                      "format": "date"
                    },
                    "top_k": {
                      "type": "integer",
                      "default": 5,
                      "maximum": 50,
                      "minimum": 1
                    },
                    "exchange": {
                      "enum": [
                        "N",
                        "Q",
                        "A",
                        "B",
                        "T",
                        "I"
                      ],
                      "type": "string"
                    },
                    "group_by_week": {
                      "type": "boolean",
                      "default": true
                    },
                    "min_constituents": {
                      "type": "integer",
                      "default": 25,
                      "maximum": 5000,
                      "minimum": 1
                    }
                  },
                  "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": "Historical sector leadership rotation with bullish share, average RSI, trend maturity, leadership_score, and weekly rank.",
              "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": [
      "RSI baseline is 100; values above 100 indicate outperformance versus benchmark.",
      "Omitting start and end applies a bounded trailing window; read applied_bounds to see the window, limit and whether the result was truncated."
    ],
    "pricing": {
      "unit": "request",
      "stc_cost": "0.300000",
      "cost_source": "/v1/pricing/catalog",
      "pricing_rule_id": "leadership_rotation_history_paid",
      "effective_price_usd": "0.300000"
    },
    "endpoint": {
      "path": "/v1/leadership/rotation/history",
      "method": "GET",
      "purpose": "Retrieve historical sector leadership rotation over time.",
      "category": "leadership",
      "access_type": "paid",
      "workflow_role": "Historical leadership rotation context.",
      "requires_payment": true
    },
    "input_rule": null,
    "example_object": {
      "count": 1,
      "weeks": [
        {
          "data": [
            {
              "avg_rsi": 108,
              "bull_pct": 0.65,
              "avg_mt_cnt": 9,
              "sector_name": "Sample Sector",
              "rank_in_week": 1,
              "leadership_score": 72.45
            }
          ],
          "count": 1,
          "weekdate": "YYYY-MM-DD"
        }
      ],
      "filters": {
        "type": "CS",
        "top_k": 5,
        "min_constituents": 25
      },
      "exchange": "N",
      "request_id": "req_demo",
      "week_count": 1
    },
    "input_location": "query",
    "output_summary": "Historical sector leadership rotation with bullish share, average RSI, trend maturity, leadership_score, and weekly rank.",
    "response_shape": [
      "request_id",
      "exchange",
      "start",
      "end",
      "filters.type",
      "filters.min_constituents",
      "filters.top_k",
      "applied_bounds.start",
      "applied_bounds.end",
      "applied_bounds.window_source",
      "applied_bounds.limit",
      "applied_bounds.limit_source",
      "applied_bounds.max_limit",
      "applied_bounds.rows_returned",
      "applied_bounds.truncated_by_limit",
      "applied_bounds.default_window_weeks",
      "applied_bounds.widen_with",
      "week_count",
      "count",
      "weeks[].weekdate",
      "weeks[].count",
      "weeks[].data[].sector_code",
      "weeks[].data[].sector_name",
      "weeks[].data[].bull_pct",
      "weeks[].data[].avg_rsi",
      "weeks[].data[].avg_mt_cnt",
      "weeks[].data[].leadership_score",
      "weeks[].data[].rank_in_week",
      "note"
    ],
    "analytical_role": "leadership_intelligence",
    "optional_inputs": {
      "end": {
        "type": "string",
        "format": "date",
        "example": "2025-12-26",
        "required": false,
        "description": "Inclusive end weekdate in YYYY-MM-DD format.",
        "input_location": "query",
        "parameter_source": "query"
      },
      "type": {
        "type": "string",
        "example": "CS",
        "required": false,
        "description": "Instrument type filter. CS is the safe default for common-stock leadership rotation.",
        "safe_default": "CS",
        "input_location": "query",
        "parameter_source": "query"
      },
      "limit": {
        "type": "integer",
        "example": 2000,
        "maximum": 50000,
        "minimum": 1,
        "required": false,
        "description": "Maximum number of rows returned. When start and end are both omitted, a trailing 104-week window ending at the latest available weekdate is applied as well. The applied_bounds block on the response reports the window and limit that were actually used.",
        "safe_default": 2000,
        "input_location": "query",
        "parameter_source": "query"
      },
      "start": {
        "type": "string",
        "format": "date",
        "example": "2025-01-03",
        "required": false,
        "description": "Inclusive start weekdate in YYYY-MM-DD format.",
        "input_location": "query",
        "parameter_source": "query"
      },
      "top_k": {
        "type": "integer",
        "example": 5,
        "maximum": 50,
        "minimum": 1,
        "required": false,
        "description": "Top sectors per week. Omit for all sectors.",
        "safe_default": 5,
        "input_location": "query",
        "parameter_source": "query"
      },
      "exchange": {
        "enum": [
          "N",
          "Q",
          "A",
          "B",
          "T",
          "I"
        ],
        "type": "string",
        "example": "N",
        "required": false,
        "description": "Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.",
        "input_location": "query",
        "parameter_source": "query"
      },
      "group_by_week": {
        "type": "boolean",
        "example": true,
        "required": false,
        "safe_default": true,
        "input_location": "query",
        "parameter_source": "query"
      },
      "min_constituents": {
        "type": "integer",
        "example": 25,
        "maximum": 5000,
        "minimum": 1,
        "required": false,
        "safe_default": 25,
        "input_location": "query",
        "parameter_source": "query"
      }
    },
    "required_inputs": {},
    "supported_rails": [
      "subscription",
      "x402",
      "mpp"
    ],
    "parameter_source": "query",
    "related_endpoints": [
      "/v1/leadership/summary/latest",
      "/v1/breadth/sector/history",
      "/v1/market/regime/history"
    ],
    "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/leadership/rotation/history",
      "query": {
        "type": "CS",
        "top_k": 5,
        "exchange": "N",
        "group_by_week": true
      },
      "method": "GET"
    },
    "investment_agent_value": "Helps agents identify where leadership is rotating across sectors before combining that context with regime, breadth, and symbol-level workflows.",
    "next_recommended_calls": [
      "/v1/market/regime/history",
      "/v1/indicators/history"
    ],
    "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",
      "resource": {
        "url": "https://api.stocktrends.com/v1/leadership/rotation/history",
        "tags": [
          "finance",
          "equities",
          "sector-rotation",
          "market-leadership",
          "rotation-history"
        ],
        "iconUrl": "https://developer.stocktrends.com/images/stmi-icon.png",
        "mimeType": "application/json",
        "description": "Historical sector leadership rotation derived from Stock Trends trend distribution, relative performance, and trend maturity measures.",
        "serviceName": "Stock Trends Market Intelligence"
      }
    },
    "payTo": "0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab",
    "amount": "300000",
    "scheme": "exact",
    "network": "eip155:8453",
    "maxTimeoutSeconds": 300
  }
]

Extensions

{
  "bazaar": {
    "info": {
      "role": "leadership_intelligence",
      "input": {
        "type": "http",
        "method": "GET",
        "queryParams": {
          "type": "CS",
          "top_k": 5,
          "exchange": "N",
          "group_by_week": true
        }
      },
      "title": "Leadership Rotation History",
      "family": "leadership",
      "output": {
        "type": "json",
        "format": "application/json",
        "example": {
          "request_id": "req_demo"
        }
      },
      "category": "leadership",
      "schemaUrl": "https://api.stocktrends.com/v1/ai/tools",
      "description": "Historical sector leadership rotation derived from Stock Trends trend distribution, relative performance, and trend maturity measures.",
      "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": {
                "end": {
                  "type": "string",
                  "format": "date"
                },
                "type": {
                  "type": "string",
                  "default": "CS"
                },
                "limit": {
                  "type": "integer",
                  "default": 2000,
                  "maximum": 50000,
                  "minimum": 1
                },
                "start": {
                  "type": "string",
                  "format": "date"
                },
                "top_k": {
                  "type": "integer",
                  "default": 5,
                  "maximum": 50,
                  "minimum": 1
                },
                "exchange": {
                  "enum": [
                    "N",
                    "Q",
                    "A",
                    "B",
                    "T",
                    "I"
                  ],
                  "type": "string"
                },
                "group_by_week": {
                  "type": "boolean",
                  "default": true
                },
                "min_constituents": {
                  "type": "integer",
                  "default": 25,
                  "maximum": 5000,
                  "minimum": 1
                }
              },
              "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": "Historical sector leadership rotation with bullish share, average RSI, trend maturity, leadership_score, and weekly rank.",
          "additionalProperties": true
        },
        "category": {
          "type": "string"
        },
        "schemaUrl": {
          "type": "string"
        },
        "description": {
          "type": "string"
        },
        "metadataUrl": {
          "type": "string"
        },
        "tools_manifest": {
          "type": "string"
        },
        "pricing_catalog": {
          "type": "string"
        }
      },
      "additionalProperties": true
    }
  }
}

Provenance

Seen in the source catalog

2026-09-24 02:23Z

Last indexed by Roundhouse

2026-09-24 07:20Z

Last enriched (probe, favicon, geo)

2026-09-23 04:15Z

x402 version

2

Max timeout

300s

Liveness probe

HTTP 402