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/breadth/sector/history",
  "payment_required": {
    "accepts": [
      {
        "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "extra": {
          "name": "USD Coin",
          "version": "2",
          "resource": {
            "url": "https://api.stocktrends.com/v1/breadth/sector/history",
            "tags": [
              "finance",
              "equities",
              "market-breadth",
              "sector-breadth",
              "breadth-history"
            ],
            "iconUrl": "https://developer.stocktrends.com/images/stmi-icon.png",
            "mimeType": "application/json",
            "description": "Historical sector, industry-group, or industry breadth series derived from Stock Trends signal distribution.",
            "serviceName": "Stock Trends Market Intelligence"
          }
        },
        "payTo": "0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab",
        "amount": "300000",
        "scheme": "exact",
        "network": "eip155:8453",
        "maxTimeoutSeconds": 300
      }
    ],
    "resource": {
      "url": "https://api.stocktrends.com/v1/breadth/sector/history",
      "tags": [
        "finance",
        "equities",
        "market-breadth",
        "sector-breadth",
        "breadth-history"
      ],
      "iconUrl": "https://developer.stocktrends.com/images/stmi-icon.png",
      "mimeType": "application/json",
      "description": "Historical sector, industry-group, or industry breadth series derived from Stock Trends signal distribution.",
      "serviceName": "Stock Trends Market Intelligence"
    },
    "extensions": {
      "bazaar": {
        "info": {
          "role": "market_breadth_context",
          "input": {
            "type": "http",
            "method": "GET",
            "queryParams": {
              "group_level": "sector",
              "group_by_week": true
            }
          },
          "title": "Sector Breadth History",
          "family": "breadth",
          "output": {
            "type": "json",
            "format": "application/json",
            "example": {
              "request_id": "req_demo"
            }
          },
          "category": "breadth",
          "schemaUrl": "https://api.stocktrends.com/v1/ai/tools",
          "description": "Historical sector, industry-group, or industry breadth series derived from Stock Trends signal distribution.",
          "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"
                    },
                    "limit": {
                      "type": "integer",
                      "default": 5000,
                      "maximum": 500000,
                      "minimum": 1
                    },
                    "start": {
                      "type": "string",
                      "format": "date"
                    },
                    "cs_only": {
                      "type": "boolean",
                      "default": true
                    },
                    "exchange": {
                      "enum": [
                        "N",
                        "Q",
                        "A",
                        "B",
                        "T",
                        "I"
                      ],
                      "type": "string"
                    },
                    "group_level": {
                      "enum": [
                        "sector",
                        "industry_group",
                        "industry"
                      ],
                      "type": "string",
                      "default": "sector"
                    },
                    "group_by_week": {
                      "type": "boolean",
                      "default": true
                    },
                    "include_unknown": {
                      "type": "boolean",
                      "default": false
                    }
                  },
                  "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 breadth groups and weekly signal distribution metrics.",
              "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": [
      "Use /v1/breadth/sector/latest for the current breadth snapshot before requesting multi-week history.",
      "Omitting start and end applies a bounded trailing window; read applied_bounds to see the window, limit and whether the result was truncated.",
      "Omitting exchange returns breadth aggregated across all exchanges, one row per weekdate and sector, using the same aggregation as /v1/breadth/sector/latest. Supply exchange to scope to a single exchange."
    ],
    "pricing": {
      "unit": "request",
      "stc_cost": "0.300000",
      "cost_source": "/v1/pricing/catalog",
      "pricing_rule_id": "breadth_sector_history_paid",
      "effective_price_usd": "0.300000"
    },
    "endpoint": {
      "path": "/v1/breadth/sector/history",
      "method": "GET",
      "purpose": "Retrieve historical breadth context across sector or industry groupings.",
      "category": "breadth",
      "access_type": "paid",
      "workflow_role": "Market breadth context.",
      "requires_payment": true
    },
    "input_rule": null,
    "example_object": {
      "weeks": [
        {
          "data": [
            {
              "avg_rsi": 100,
              "group_name": "Sample Sector",
              "bearish_count": 0,
              "bullish_count": 0
            }
          ],
          "count": 1,
          "weekdate": "YYYY-MM-DD"
        }
      ],
      "request_id": "req_demo",
      "week_count": 1,
      "group_level": "sector"
    },
    "input_location": "query",
    "output_summary": "Historical breadth groups and weekly signal distribution metrics.",
    "response_shape": [
      "request_id",
      "group_level",
      "exchange",
      "start",
      "end",
      "cs_only",
      "include_unknown",
      "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[].data[].bullish_count",
      "weeks[].data[].bearish_count",
      "weeks[].data[].avg_rsi",
      "note"
    ],
    "analytical_role": "market_breadth_context",
    "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"
      },
      "limit": {
        "type": "integer",
        "example": 5000,
        "maximum": 500000,
        "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": 5000,
        "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"
      },
      "cs_only": {
        "type": "boolean",
        "example": true,
        "required": false,
        "description": "Filter to Common Stocks only where the endpoint supports instrument type filtering.",
        "safe_default": true,
        "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_level": {
        "enum": [
          "sector",
          "industry_group",
          "industry"
        ],
        "type": "string",
        "required": false,
        "safe_default": "sector",
        "input_location": "query",
        "parameter_source": "query"
      },
      "group_by_week": {
        "type": "boolean",
        "required": false,
        "safe_default": true,
        "input_location": "query",
        "parameter_source": "query"
      },
      "include_unknown": {
        "type": "boolean",
        "required": false,
        "safe_default": false,
        "input_location": "query",
        "parameter_source": "query"
      }
    },
    "required_inputs": {},
    "supported_rails": [
      "subscription",
      "x402",
      "mpp"
    ],
    "parameter_source": "query",
    "related_endpoints": [
      "/v1/breadth/sector/latest",
      "/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/breadth/sector/history",
      "query": {
        "group_level": "sector",
        "group_by_week": true
      },
      "method": "GET"
    },
    "investment_agent_value": "Helps agents identify whether leadership and breadth are broadening or narrowing over time.",
    "next_recommended_calls": [
      "/v1/market/regime/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",
      "resource": {
        "url": "https://api.stocktrends.com/v1/breadth/sector/history",
        "tags": [
          "finance",
          "equities",
          "market-breadth",
          "sector-breadth",
          "breadth-history"
        ],
        "iconUrl": "https://developer.stocktrends.com/images/stmi-icon.png",
        "mimeType": "application/json",
        "description": "Historical sector, industry-group, or industry breadth series derived from Stock Trends signal distribution.",
        "serviceName": "Stock Trends Market Intelligence"
      }
    },
    "payTo": "0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab",
    "amount": "300000",
    "scheme": "exact",
    "network": "eip155:8453",
    "maxTimeoutSeconds": 300
  }
]

Extensions

{
  "bazaar": {
    "info": {
      "role": "market_breadth_context",
      "input": {
        "type": "http",
        "method": "GET",
        "queryParams": {
          "group_level": "sector",
          "group_by_week": true
        }
      },
      "title": "Sector Breadth History",
      "family": "breadth",
      "output": {
        "type": "json",
        "format": "application/json",
        "example": {
          "request_id": "req_demo"
        }
      },
      "category": "breadth",
      "schemaUrl": "https://api.stocktrends.com/v1/ai/tools",
      "description": "Historical sector, industry-group, or industry breadth series derived from Stock Trends signal distribution.",
      "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"
                },
                "limit": {
                  "type": "integer",
                  "default": 5000,
                  "maximum": 500000,
                  "minimum": 1
                },
                "start": {
                  "type": "string",
                  "format": "date"
                },
                "cs_only": {
                  "type": "boolean",
                  "default": true
                },
                "exchange": {
                  "enum": [
                    "N",
                    "Q",
                    "A",
                    "B",
                    "T",
                    "I"
                  ],
                  "type": "string"
                },
                "group_level": {
                  "enum": [
                    "sector",
                    "industry_group",
                    "industry"
                  ],
                  "type": "string",
                  "default": "sector"
                },
                "group_by_week": {
                  "type": "boolean",
                  "default": true
                },
                "include_unknown": {
                  "type": "boolean",
                  "default": false
                }
              },
              "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 breadth groups and weekly signal distribution metrics.",
          "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 12:50Z

Last enriched (probe, favicon, geo)

2026-09-20 21:15Z

x402 version

2

Max timeout

300s

Liveness probe

HTTP 402