patternfetch

{
  "name": "patternfetch",
  "description": "Agent-first market-state API: ticker + timeframe -> token-compact brief (compact candles, chart/candlestick patterns with backtested base rates, support/resistance, regime, interpreted indicators, historical analogs) plus a ranked cross-market scanner. US stocks/ETFs and crypto spot.",
  "version": "0.3.0",
  "protocolVersion": "0.2.9",
  "url": "https://patternfetch.com/mcp",
  "preferredTransport": "streamable-http",
  "documentationUrl": "https://patternfetch.com/docs",
  "provider": {
    "organization": "patternfetch",
    "url": "https://patternfetch.com"
  },
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false
  },
  "defaultInputModes": [
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "securitySchemes": {
    "bearer": {
      "type": "http",
      "scheme": "bearer",
      "description": "patternfetch API key \u2014 free tier at POST /v1/keys"
    },
    "oauth2": {
      "type": "oauth2",
      "description": "One-click OAuth 2.1 + PKCE; issues a free-tier key as the access token.",
      "metadata": "https://patternfetch.com/.well-known/oauth-authorization-server"
    }
  },
  "security": [
    {
      "bearer": []
    },
    {
      "oauth2": [
        "patternfetch:use"
      ]
    }
  ],
  "skills": [
    {
      "id": "brief",
      "name": "market-state brief",
      "description": "Get a token-compact market-state brief for a stock, ETF, or crypto ticker + timeframe. Returns compact candles, detected chart/candlestick patterns with geometric confidence AND a backtested historical base rate (how often that pattern+timeframe+confidence-band actually resolved its way), support/resistance levels, trend/regime, and interpreted indicators (RSI/EMA state) plus a one-line summary. Covers US stocks/ETFs (split & dividend adjusted, delayed/EOD) and crypto spot (realtime). WHEN: an agent needs the current technical picture of a market without dumping raw OHLCV into context (saves tokens, avoids numeric hallucination). WHEN NOT: you need order execution or portfolio advice. Examples: {\"ticker\":\"AAPL\",\"timeframe\":\"1d\"}, {\"ticker\":\"BTC/USDT\",\"timeframe\":\"4h\"}. Output is impersonal market data, NOT investment advice.",
      "tags": [
        "market-data",
        "technical-analysis"
      ]
    },
    {
      "id": "multi",
      "name": "multi-timeframe view",
      "description": "Get a multi-timeframe market-state view for one stock, ETF, or crypto ticker in a single call: a token-compact brief for each requested timeframe (default 1h, 4h, 1d) PLUS a cross-timeframe alignment read \u2014 whether the trends across timeframes agree or diverge, with the split spelled out (e.g. \"1h up / 4h up / 1d down\"). WHEN: an agent wants to know if a setup is confirmed across horizons or conflicting between them, without making 3 separate brief calls. WHEN NOT: you only care about one timeframe (use brief). The alignment/divergence is impersonal DESCRIPTIVE data, not a signal to act on. Example: {\"ticker\":\"BTC/USDT\",\"timeframes\":[\"1h\",\"4h\",\"1d\"]}. Not investment advice.",
      "tags": [
        "market-data",
        "multi-timeframe"
      ]
    },
    {
      "id": "delta",
      "name": "what changed since last look",
      "description": "Get only what CHANGED since your last brief for a ticker+timeframe (trend flips, new patterns, RSI-state changes). WHEN: an agent polls the same market repeatedly and wants minimal tokens \u2014 call brief once, then delta on each later poll. WHEN NOT: first look at a market (use brief). Returns changed=false when nothing material changed. Example: {\"ticker\":\"BTC/USDT\",\"timeframe\":\"4h\"}. Impersonal data, not advice.",
      "tags": [
        "market-data",
        "polling"
      ]
    },
    {
      "id": "analogs",
      "name": "historical analogs",
      "description": "Find earlier windows IN THE SAME SERIES whose shape resembles the current price action and return the FULL distribution of what followed (win-rate, median, min, max, n) over a fixed forward horizon. Parameters: window = how many recent bars form the shape being matched (default 32); horizon = how many bars forward each match is measured over (default 20). WHEN: an agent wants the historical spread of outcomes after a similar-looking setup, including how wide and how uncertain that spread is. WHEN NOT: you want the current technical picture (use brief), you want to find candidates across the market (use scan), or you need one expected value \u2014 this deliberately returns a distribution, not a point estimate. NOT a prediction, NOT a backtest of a strategy; past distribution does not guarantee future results. Example: {\"ticker\":\"ETH/USDT\",\"timeframe\":\"1d\"}. Impersonal data, not advice.",
      "tags": [
        "market-data",
        "history"
      ]
    },
    {
      "id": "scan",
      "name": "ranked market scanner",
      "description": "Scan US stocks, ETFs, and crypto for tickers currently in a given regime or showing a chart/candlestick pattern, RANKED by the honest backtested base rate + 95% CI \u2014 discovery, NOT lookup. This is the screener: instead of asking about one ticker you already know, ask \"which tickers right now are in an uptrend / printing a double_bottom, and which of those has the strongest historical base rate?\" and get a ranked shortlist back. Precomputed daily over a curated universe (liquid US large-caps + core/sector ETFs + major crypto pairs) so it is fast and cheap. Filters (all optional): assetClass (\"stock\"|\"crypto\"|\"all\"), regime (\"up\"|\"down\"|\"range\"), pattern (e.g. \"double_bottom\",\"double_top\",\"head_and_shoulders\",\"bullish_engulfing\",\"bearish_engulfing\",\"hammer\"), minLift (-1..1 in rate points, e.g. 0.02 = keep only patterns beating their OWN pattern-free baseline by >= 2pp; 0 = at or above baseline), minBaseRate (0..1, drop tickers whose top pattern base rate is below this), tf, limit. PREFER minLift over minBaseRate: a raw base rate is not comparable across bullish and bearish rows, so minBaseRate:0.55 mostly returns bullish patterns in a rising universe before any of them carries information, whereas minLift returns the ones that measurably add something. Rows with no baseline in the evidence table are excluded by any minLift (absence of a lift is not a lift of 0). Each row: {sym, tf, assetClass, regime, pattern, baseRate, ci95, n, scope, confidence, asOf} PLUS the drift-free comparison {baseline, lift, liftCi95, liftReading} \u2014 baseline is the direction-matched rate with no pattern present, lift is baseRate minus that baseline, and liftReading says whether the difference is distinguishable from zero at all (\"above-baseline\" | \"below-baseline\" | \"indistinguishable-from-baseline\"). Read lift, not baseRate, when comparing a bullish row against a bearish one: in a rising universe a bullish pattern starts ahead before it carries any information. Ranked by baseRate desc, then confidence desc, then narrower CI, then fresher asOf. WHEN: an agent wants to FIND candidates across the market, not analyze a named one (then call brief on the shortlist). WHEN NOT: you already have a specific ticker (use brief). Example: {\"assetClass\":\"all\",\"regime\":\"up\",\"minLift\":0.02,\"limit\":20}. Impersonal historical data, not investment advice; base rates are gross directional frequencies and do not guarantee future results.",
      "tags": [
        "screener",
        "discovery"
      ]
    }
  ],
  "assets": [
    "crypto-spot",
    "stock",
    "etf"
  ],
  "timeframes": [
    "1m",
    "5m",
    "15m",
    "30m",
    "1h",
    "4h",
    "1d",
    "1w"
  ],
  "endpoints": [
    "/v1/brief",
    "/v1/multi",
    "/v1/delta",
    "/v1/candles",
    "/v1/analogs",
    "/v1/scan",
    "/v1/demo",
    "/v1/demo-multi",
    "/v1/keys",
    "/v1/topup",
    "/v1/checkout",
    "/v1/subscribe",
    "/healthz",
    "/v1/status",
    "/v1/platforms",
    "/mcp"
  ],
  "legal": "impersonal \u00b7 informational only \u00b7 not advice \u00b7 not personalized \u00b7 non-executing",
  "disclaimer": "Impersonal market data for informational purposes only. Not investment advice, not personalized, non-executing."
}