HPSILab Quant Finance

{
  "protocolVersion": "0.2.0",
  "name": "HPSILab Quant Finance",
  "description": "Quantitative stock and options research for AI agents: AI price predictions, implied-volatility structure, options pressure maps, Monte Carlo simulation, strategy backtests, and pre-trade risk scans. Research only - it never places, routes, or manages orders.",
  "url": "https://hpsilab.com",
  "provider": {
    "organization": "HPSILab",
    "url": "https://hpsilab.com"
  },
  "version": "1.2.0",
  "documentationUrl": "https://hpsilab.com/developer/v2",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false
  },
  "defaultInputModes": [
    "text/plain",
    "application/json"
  ],
  "defaultOutputModes": [
    "text/plain",
    "application/json"
  ],
  "skills": [
    {
      "id": "analyze_stock",
      "name": "Stock Analysis",
      "description": "Aggregate direction score, contributing factors, and a plain-language summary.",
      "tags": [
        "finance",
        "quantitative-research",
        "options",
        "equities"
      ]
    },
    {
      "id": "get_ai_prediction",
      "name": "AI Prediction",
      "description": "Up-probability, paper-trading buy/watch/sell lean (research only, not a trade instruction), and model consensus for a ticker.",
      "tags": [
        "finance",
        "quantitative-research",
        "options",
        "equities"
      ]
    },
    {
      "id": "get_iv_radar",
      "name": "Implied Volatility Radar",
      "description": "IV structure, rank/percentile, squeeze score, and 25-delta risk reversal.",
      "tags": [
        "finance",
        "quantitative-research",
        "options",
        "equities"
      ]
    },
    {
      "id": "get_option_pressure",
      "name": "Options Pressure Map",
      "description": "Max Pain, Gamma Wall, likely weekly high, and squeeze target.",
      "tags": [
        "finance",
        "quantitative-research",
        "options",
        "equities"
      ]
    },
    {
      "id": "get_monte_carlo",
      "name": "Monte Carlo Simulation",
      "description": "10-day price distribution, mean close, and up-probability.",
      "tags": [
        "finance",
        "quantitative-research",
        "options",
        "equities"
      ]
    },
    {
      "id": "get_equity_curve",
      "name": "Strategy Backtest",
      "description": "Sharpe ratio, max drawdown, win rate, and total return.",
      "tags": [
        "finance",
        "quantitative-research",
        "options",
        "equities"
      ]
    },
    {
      "id": "get_pretrade_risk_scan",
      "name": "Pre-Trade Risk Scan",
      "description": "Full pre-trade risk assessment for a position before entering it.",
      "tags": [
        "finance",
        "quantitative-research",
        "options",
        "equities"
      ]
    },
    {
      "id": "generate_stock_images",
      "name": "Stock Chart Generator",
      "description": "Renders stock-report chart PNGs and returns hosted URLs.",
      "tags": [
        "finance",
        "quantitative-research",
        "options",
        "equities"
      ]
    },
    {
      "id": "generate_stock_research_report",
      "name": "Stock Research Report",
      "description": "Markdown research report with embedded charts.",
      "tags": [
        "finance",
        "quantitative-research",
        "options",
        "equities"
      ]
    },
    {
      "id": "register_account",
      "name": "Register a Free Account",
      "description": "Creates a free account for the calling agent and returns an API key.",
      "tags": [
        "finance",
        "quantitative-research",
        "options",
        "equities"
      ]
    }
  ],
  "authentication": {
    "anonymous": {
      "required": false,
      "description": "Call with no credentials at all for a small anonymous trial. An anonymous key is handed back on successful calls in the X-HPSILAB-Anon-Key response header; sending it back keeps the same trial identity across calls but adds no quota. For your own API key and trial Credits, register free at https://hpsilab.com/register or call register_account.",
      "issuedInHeader": "X-HPSILAB-Anon-Key"
    },
    "selfRegistration": {
      "description": "Agents can register their own account with no human step: no password, no wallet, no web form. Returns a real API key, and binds the account to the caller so later calls are recognised even if the caller cannot change its own Authorization header.",
      "endpoint": "https://hpsilab.com/api/agent/register",
      "method": "POST",
      "body": {
        "email": "string"
      },
      "mcpTool": "register_account"
    },
    "apiKey": {
      "scheme": "bearer",
      "description": "Personal API key (prefix 'hpsi_') sent as 'Authorization: Bearer'.",
      "manageUrl": "https://hpsilab.com/settings"
    },
    "oauth2": {
      "description": "OAuth 2.1 authorization code + PKCE with dynamic client registration.",
      "metadataUrl": "https://hpsilab.com/.well-known/oauth-authorization-server",
      "requiresHumanApproval": true,
      "unattendedAlternative": "anonymous"
    }
  },
  "pricing": {
    "model": "freemium",
    "freeTier": {
      "anonymousCallsPerDay": 10,
      "anonymousKeyedCallsPerDay": 10,
      "registeredFreeCallsPerDay": 5000,
      "note": "Anonymous callers share one daily pool across all free tools. Once it is spent, calls are answered with the last known-good result marked X-HPSILAB-Degraded: true, not an empty error."
    },
    "perCall": {
      "protocol": "x402",
      "network": "eip155:8453",
      "asset": "USDC",
      "prices": {
        "get_pretrade_risk_scan": "$0.15",
        "generate_stock_research_report": "$0.35",
        "analyze_stock": "$0.15",
        "generate_stock_images": "$0.20",
        "get_monte_carlo": "$0.10",
        "get_iv_radar": "$0.05",
        "get_option_pressure": "$0.05",
        "get_ai_prediction": "$0.05",
        "get_equity_curve": "$0.07"
      },
      "walletFreeAlternative": {
        "description": "A wallet is not required. Every payment challenge also names a card checkout URL for agents with no USDC.",
        "url": "https://hpsilab.com/pricing"
      }
    },
    "plansUrl": "https://hpsilab.com/pricing"
  },
  "disclaimer": "Research and informational use only. Not investment advice. This service never places, routes, or manages orders.",
  "interfaces": {
    "mcp": {
      "url": "https://hpsilab.com/mcp",
      "transport": "streamable-http"
    },
    "rest": {
      "url": "https://hpsilab.com/api",
      "openapi": "https://hpsilab.com/openapi.json"
    }
  }
}