API reference / AI research & scores

AI research & scores

A tier above resale: one call that scores or synthesizes across the whole catalog. An AI research memo, transparent 0–100 squeeze / insider / factor scores, a portfolio risk x-ray, and a natural-language screener.

6 endpoints. Pay per call in USDC via x402 with no account, or get unlimited calls for $99/mo. Every response is shaped { ticker, data, source, as_of }.

GET/api/v1/research/{ticker}$0.75

AI equity-research report: bull/bear case, valuation, catalysts, risks, and a per-signal read-out for one stock

A full AI-synthesized equity-research memo for one US stock in one call. Fans out across profile, fundamentals, technicals, short interest, insider activity (Form 4/144), 13D/G stakes, 8-K events, news and sentiment, then an LLM distils a balanced bull/bear case, valuation context, catalysts, risks and a per-signal read-out with an overall stance. Factual synthesis, not advice.

Example request
GET /api/v1/research/AAPL
Response type (TypeScript)
interface ResearchResponse {
  ticker: string;
  source: string;
  as_of: string;
  sections: {
    profile: string;
    snapshot: string;
    financials: string;
    technicals: string;
    short_interest: string;
    insider: string;
    form_144: string;
    ownership: string;
    material_events: string;
    news: string;
    sentiment: string;
    congress: string;
  };
  completeness: {
    sections_ok: number;
    sections_total: number;
    fraction: number;
  };
  memo_generated: boolean;
  report: {
    thesis_summary: string;
    bull_case: string[];
    bear_case: string[];
    valuation_context: string;
    catalysts: string[];
    risk_factors: string[];
    signal_readout: {
      insider: string;
      short_interest: string;
      technical: string;
      sentiment: string;
      institutional: string;
    };
    overall_stance: string;
    confidence: string;
  };
  evidence: {
    ticker: string;
    profile: {
      name: string;
      sector: string;
      market_cap: number;
      employees: number;
      exchange: string;
      description: string;
    };
    price: {
      change_percent: number;
      last_close: number;
      previous_close: number;
      volume: number;
    };
    technicals: {
      rsi_14: number;
      sma_50: number;
      ema_20: number;
      macd: {
        timestamp: string;
        value: number;
        signal: number;
        histogram: number;
      };
    };
    fundamentals: {
      fiscal_year: string;
      fiscal_period: string;
      revenue: number;
      net_income: number;
      gross_profit: number;
      eps_basic: number;
      revenue_growth_yoy: number;
    };
    short_interest: {
      days_to_cover: number;
      short_interest: number;
      settlement_date: string;
    };
    insider: {
      buys: number;
      sells: number;
      shares_bought: number;
      shares_sold: number;
      net_shares: number;
      signal: string;
    };
    form144_pending: number;
    activist_filings: {
      count: number;
      schedules: string[];
    };
    material_events: Array<{
      date: string;
      items: string[];
    }>;
    recent_news: Array<{
      title: string;
      published_at: string;
    }>;
    news_sentiment: {
      label: string;
      average_tone: null;
      trend: string;
    };
    peers: string[];
    congress_trades: {
      count: number;
      recent: unknown[];
    };
  };
  model: string;
  disclaimer: string;
}
Example response (click to expand)
{
  "ticker": "AAPL",
  "source": "x402stock",
  "as_of": "2026-06-09T04:27:01.765Z",
  "sections": {
    "profile": "ok",
    "snapshot": "ok",
    "financials": "ok",
    "technicals": "ok",
    "short_interest": "ok",
    "insider": "ok",
    "form_144": "ok",
    "ownership": "ok",
    "material_events": "ok",
    "news": "ok",
    "sentiment": "ok",
    "congress": "ok"
  },
  "completeness": {
    "sections_ok": 12,
    "sections_total": 12,
    "fraction": 1
  },
  "memo_generated": true,
  "report": {
    "thesis_summary": "Apple Inc. is a leading technology company with a strong portfolio of products and services, primarily driven by iPhone sales. Recent performance shows a slight decline in stock price, while fundamentals indicate steady revenue growth. However, insider selling raises concerns about future prospects.",
    "bull_case": [
      "Strong revenue growth of 6.43% year-over-year, indicating robust demand for products.",
      "Diverse product ecosystem with continuous innovation in software and services.",
      "Large market capitalization of over $4.5 trillion, providing stability and resources for growth."
    ],
    "bear_case": [
      "Recent insider selling, with a net of 378,493 shares sold, may signal lack of confidence among executives.",
      "Stock price has declined by over 2% recently, reflecting potential market concerns.",
      "High short interest of 138,782,718 shares could indicate bearish sentiment among investors."
    ],
    "valuation_context": "Current EPS is 7.49, with a market cap of $4.5 trillion, suggesting a premium valuation relative to peers.",
    "catalysts": [
      "Upcoming product launches and updates in the software ecosystem could drive sales.",
      "Continued expansion into AI and augmented reality may open new revenue streams."
    ],
    "risk_factors": [
      "Dependence on iPhone sales, which constitute a majority of revenue.",
      "Potential regulatory scrutiny in the tech sector could impact operations."
    ],
    "signal_readout": {
      "insider": "Net selling observed, with 2 buys and 15 sells.",
      "short_interest": "High short interest of 138,782,718 shares, with a days to cover of 2.74.",
      "technical": "RSI at 53.22 indicates neutral momentum; recent price decline may suggest caution.",
      "sentiment": "News sentiment is currently labeled as unknown, indicating mixed market perceptions.",
      "institutional": "No specific institutional activity reported."
    },
    "overall_stance": "mixed",
    "confidence": "medium"
  },
  "evidence": {
    "ticker": "AAPL",
    "profile": {
      "name": "Apple Inc.",
      "sector": "ELECTRONIC COMPUTERS",
      "market_cap": 4514011993040,
      "employees": 166000,
      "exchange": "XNAS",
      "description": "Apple is among the largest companies in the world, with a broad portfolio of hardware and software products targeted at consumers and businesses. Apple's iPhone makes up a majority of the firm sales, and Apple's other products like Mac, iPad, and Watch are designed around the iPhone as the focal point of an expansive software ecosystem. Apple has progressively worked to add new applications, like streaming video, subscription bundles, and augmented reality. The firm designs its own software and …"
    },
    "price": {
      "change_percent": -2.1689334287759476,
      "last_close": 301.54,
      "previous_close": 307.34,
      "volume": 77949483
    },
    "technicals": {
      "rsi_14": 53.22391461916807,
      "sma_50": 282.21040000000005,
      "ema_20": 302.55295015666843,
      "macd": {
        "timestamp": "2026-06-08T04:00:00.000Z",
        "value": 7.364532788593294,
        "signal": 8.98867042895903,
        "histogram": -1.6241376403657348
      }
    },
    "fundamentals": {
      "fiscal_year": "2025",
      "fiscal_period": "FY",
      "revenue": 416161000000,
      "net_income": 112010000000,
      "gross_profit": 195201000000,
      "eps_basic": 7.49,
      "revenue_growth_yoy": 0.0643
    },
    "short_interest": {
      "days_to_cover": 2.74,
      "short_interest": 138782718,
      "settlement_date": "2026-05-15"
    },
    "insider": {
      "buys": 2,
      "sells": 15,
      "shares_bought": 12645,
      "shares_sold": 391138,
      "net_shares": -378493,
      "signal": "net_selling"
    },
    "form144_pending": 8,
    "activist_filings": {
      "count": 8,
      "schedules": [
        "13G",
        "13G",
        "13G",
        "13G",
        "13G"
      ]
    },
    "material_events": [
      {
        "date": "2026-04-30",
        "items": [
          "Results of Operations and Financial Condition",
          "Financial Statements and Exhibits"
        ]
      },
      {
        "date": "2026-04-20",
        "items": [
          "Departure/Election of Directors or Officers; Compensatory Arrangements"
        ]
      },
      {
        "date": "2026-02-24",
        "items": [
          "Submission of Matters to a Vote of Security Holders",
          "Financial Statements and Exhibits"
        ]
      },
      {
        "date": "2026-01-29",
        "items": [
          "Results of Operations and Financial Condition",
          "Financial Statements and Exhibits"
        ]
      },
      {
        "date": "2026-01-02",
        "items": [
          "Departure/Election of Directors or Officers; Compensatory Arrangements"
        ]
      },
      {
        "date": "2025-12-05",
        "items": [
          "Departure/Election of Directors or Officers; Compensatory Arrangements"
        ]
      }
    ],
    "recent_news": [
      {
        "title": "Stock Market Today, June 8: Apple Falls After Unveiling AI Siri and Apple Intelligence at WWDC",
        "published_at": "2026-06-08T21:09:10Z"
      },
      {
        "title": "Stock Market Today, June 8: Marvell, Intel, and Micron Lead Tech Stock Rebound",
        "published_at": "2026-06-08T21:03:32Z"
      },
      {
        "title": "Why is this Wealth Manager Buying 1 M
… (truncated — call the endpoint for the full response)
GET/api/v1/score/squeeze/{ticker}$0.15

Short-squeeze score (0–100): a weighted gauge of short interest, days-to-cover, short volume, FTDs and spark

A transparent 0–100 short-squeeze pressure score for a US stock. Combines short interest as a % of shares, days-to-cover, the daily short-volume ratio, fails-to-deliver vs average volume, and a price/social spark into one gauge — with the full sub-factor breakdown and the raw inputs it scored. Factual quantitative reading, not advice.

Example request
GET /api/v1/score/squeeze/AAPL
Response type (TypeScript)
interface SqueezeScoreResponse {
  ticker: string;
  source: string;
  as_of: string;
  sections: {
    short_interest: string;
    short_volume: string;
    fails_to_deliver: string;
  };
  score: {
    value: number;
    max: number;
    label: string;
    confidence: number;
    factors: Array<{
      name: string;
      label: string;
      score: number;
      max: number;
      value: number;
      unit: string;
    }>;
  };
  methodology: string;
  inputs: {
    short_interest: {
      settlement_date: string;
      short_interest: number;
      avg_daily_volume: number;
      days_to_cover: number;
    };
    short_volume_ratio: number;
    fails_to_deliver_latest: {
      settlement_date: string;
      cusip: string;
      symbol: string;
      fails: number;
      description: string;
      price: number;
    };
    shares_outstanding: number;
    day_change_percent: number;
    days_to_cover_rising: boolean;
    social: {
      reddit: boolean;
      fourchan: boolean;
      reddit_rank: number;
    };
  };
  rationale: string;
  disclaimer: string;
}
Example response (click to expand)
{
  "ticker": "GME",
  "source": "x402stock",
  "as_of": "2026-06-09T04:27:45.903Z",
  "sections": {
    "short_interest": "ok",
    "short_volume": "ok",
    "fails_to_deliver": "ok"
  },
  "score": {
    "value": 58,
    "max": 100,
    "label": "elevated",
    "confidence": 1,
    "factors": [
      {
        "name": "short_interest_pct",
        "label": "Short interest vs shares outstanding",
        "score": 18,
        "max": 30,
        "value": 12.91,
        "unit": "%"
      },
      {
        "name": "days_to_cover",
        "label": "Days to cover",
        "score": 9,
        "max": 25,
        "value": 4.16,
        "unit": "days"
      },
      {
        "name": "short_volume_ratio",
        "label": "Daily short-volume ratio",
        "score": 15,
        "max": 20,
        "value": 54.1,
        "unit": "%"
      },
      {
        "name": "fails_to_deliver",
        "label": "Fails-to-deliver vs ADV",
        "score": 10,
        "max": 15,
        "value": 3.19,
        "unit": "%"
      },
      {
        "name": "spark",
        "label": "Price momentum + social attention",
        "score": 6,
        "max": 10,
        "value": 1.83,
        "unit": "%chg"
      }
    ]
  },
  "methodology": "Weighted 5-factor gauge: short interest %-of-shares (30) + days-to-cover (25) + daily short-volume ratio (20) + fails-to-deliver vs ADV (15) + price/social spark (10). Higher = more squeeze pressure.",
  "inputs": {
    "short_interest": {
      "settlement_date": "2026-05-15",
      "short_interest": 57937281,
      "avg_daily_volume": 13910930,
      "days_to_cover": 4.16
    },
    "short_volume_ratio": 54.1,
    "fails_to_deliver_latest": {
      "settlement_date": "2026-05-14",
      "cusip": "36467W109",
      "symbol": "GME",
      "fails": 443681,
      "description": "GAMESTOP CORP (HLDG CO) CL A",
      "price": 22.08
    },
    "shares_outstanding": 448691227,
    "day_change_percent": 1.826146788990823,
    "days_to_cover_rising": false,
    "social": {
      "reddit": true,
      "fourchan": true,
      "reddit_rank": 69
    }
  },
  "rationale": "GME scores 58/100 (elevated) for short-squeeze pressure. Biggest contributor: daily short-volume ratio (15/20). Days to cover 4.2. Short interest ≈ 12.9% of shares. Currently trending on retail forums.",
  "disclaimer": "Factual quantitative analysis, not investment advice. Inputs are delayed/periodic; verify before acting."
}
GET/api/v1/score/insider/{ticker}$0.15

Insider-conviction score (0–100): net Form 4 flow, role weighting, cluster buys, Form 144 and 13D

A transparent 0–100 insider-conviction score for a US stock. Starts neutral, then adjusts for net Form 4 buy/sell share flow, role-weighted activity (C-suite and 10% owners weigh more), cluster buying by distinct insiders, Form 144 intent-to-sell overhang, and any activist 13D stake — returning the full factor breakdown. From SEC EDGAR. Factual, not advice.

Example request
GET /api/v1/score/insider/AAPL
Response type (TypeScript)
interface InsiderScoreResponse {
  ticker: string;
  source: string;
  as_of: string;
  sections: {
    insider_trades: string;
    form_144: string;
    beneficial_ownership: string;
  };
  score: {
    value: number;
    max: number;
    label: string;
    confidence: number;
    baseline: number;
    factors: Array<{
      name: string;
      label: string;
      points: number;
      detail?: {
        open_buys: number;
        open_sells: number;
        net_shares: number;
      };
    }>;
  };
  methodology: string;
  inputs: {
    open_market: {
      buys: number;
      sells: number;
      shares_bought: number;
      shares_sold: number;
      net_shares: number;
    };
    reported_summary: {
      buys: number;
      sells: number;
      shares_bought: number;
      shares_sold: number;
      net_shares: number;
      signal: string;
    };
    form144_notices: number;
    schedule_13_filings: number;
  };
  rationale: string;
  disclaimer: string;
}
Example response (click to expand)
{
  "ticker": "AAPL",
  "source": "x402stock",
  "as_of": "2026-06-09T04:27:48.357Z",
  "sections": {
    "insider_trades": "ok",
    "form_144": "ok",
    "beneficial_ownership": "ok"
  },
  "score": {
    "value": 0,
    "max": 100,
    "label": "strong_selling",
    "confidence": 1,
    "baseline": 50,
    "factors": [
      {
        "name": "net_flow",
        "label": "Net open-market (P/S) buy/sell share flow",
        "points": -30,
        "detail": {
          "open_buys": 0,
          "open_sells": 13,
          "net_shares": -397759
        }
      },
      {
        "name": "role_weighted",
        "label": "Role-weighted open-market activity (C-suite/10% owners weigh more)",
        "points": -15
      },
      {
        "name": "cluster",
        "label": "Cluster buying (distinct insiders buying)",
        "points": 0,
        "detail": {
          "distinct_buyers": 0
        }
      },
      {
        "name": "intent_to_sell",
        "label": "Form 144 intent-to-sell overhang",
        "points": -15,
        "detail": {
          "notices": 10,
          "aggregate_value": 180904305.99999997
        }
      },
      {
        "name": "activist_13d",
        "label": "Activist 13D stake on file",
        "points": 0,
        "detail": {
          "schedule_13_count": 10,
          "has_13d": false
        }
      }
    ]
  },
  "methodology": "Starts at a neutral 50, then adjusts for net OPEN-MARKET (Form 4 code P/S) share flow (±30), role-weighted open-market activity (±15), cluster buying (+12), Form 144 intent-to-sell overhang (−15), and an activist 13D stake (+5). Grants/option-exercises are excluded.",
  "inputs": {
    "open_market": {
      "buys": 0,
      "sells": 13,
      "shares_bought": 0,
      "shares_sold": 397759,
      "net_shares": -397759
    },
    "reported_summary": {
      "buys": 8,
      "sells": 37,
      "shares_bought": 335341,
      "shares_sold": 973294,
      "net_shares": -637953,
      "signal": "net_selling"
    },
    "form144_notices": 10,
    "schedule_13_filings": 10
  },
  "rationale": "AAPL scores 0/100 (strong selling) for insider conviction. 0 open-market buys vs 13 sells. 10 Form 144 sell notice(s) pending. ",
  "disclaimer": "Factual quantitative analysis, not investment advice. Inputs are delayed/periodic; verify before acting."
}
GET/api/v1/score/factors/{ticker}$0.15

Quant factor score: value, quality, growth and momentum sub-scores plus a composite (0–100)

A transparent quant factor score for a US stock: Value (P/E, P/S, P/B), Quality (ROE, margins, leverage), Growth (YoY revenue & earnings) and Momentum (trailing return), each 0–100 from filing-grade fundamentals plus an equal-weighted composite. Returns every metric it scored, with labels. Factual, not advice.

Example request
GET /api/v1/score/factors/AAPL
Response type (TypeScript)
interface FactorScoreResponse {
  ticker: string;
  source: string;
  as_of: string;
  sections: {
    financials: string;
    price: string;
    price_history: string;
    profile: string;
  };
  composite: {
    value: number;
    max: number;
    label: string;
    confidence: number;
  };
  factors: {
    value: {
      score: number;
      label: string;
      metrics: {
        pe: number;
        ps: number;
        pb: number;
      };
    };
    quality: {
      score: number;
      label: string;
      metrics: {
        roe: number;
        gross_margin: number;
        net_margin: number;
        debt_to_equity: number;
      };
    };
    growth: {
      score: number;
      label: string;
      metrics: {
        revenue_growth_yoy: number;
        earnings_growth_yoy: number;
      };
    };
    momentum: {
      score: number;
      label: string;
      metrics: {
        trailing_return: number;
        above_mean: boolean;
      };
    };
  };
  methodology: string;
  inputs: {
    market_cap: number;
    price: number;
    fiscal_year: string;
    revenue: number;
    net_income: number;
    equity: number;
  };
  disclaimer: string;
}
Example response (click to expand)
{
  "ticker": "MSFT",
  "source": "x402stock",
  "as_of": "2026-06-09T04:28:06.033Z",
  "sections": {
    "financials": "ok",
    "price": "ok",
    "price_history": "ok",
    "profile": "ok"
  },
  "composite": {
    "value": 63.5,
    "max": 100,
    "label": "above_average",
    "confidence": 1
  },
  "factors": {
    "value": {
      "score": 26.7,
      "label": "weak",
      "metrics": {
        "pe": 30.4,
        "ps": 10.99,
        "pb": 9.01
      }
    },
    "quality": {
      "score": 96.3,
      "label": "strong",
      "metrics": {
        "roe": 0.2965,
        "gross_margin": 0.6882,
        "net_margin": 0.3615,
        "debt_to_equity": 0.126
      }
    },
    "growth": {
      "score": 71,
      "label": "above_average",
      "metrics": {
        "revenue_growth_yoy": 0.1493,
        "earnings_growth_yoy": 0.1554
      }
    },
    "momentum": {
      "score": 60,
      "label": "above_average",
      "metrics": {
        "trailing_return": 0.064,
        "above_mean": true
      }
    }
  },
  "methodology": "Four equally-weighted factors, each 0–100 from absolute thresholds (not cross-sectional percentiles): Value (P/E, P/S, P/B — lower is better), Quality (ROE, gross & net margin, debt/equity), Growth (YoY revenue & earnings), Momentum (trailing price return). Composite = mean of available factors.",
  "inputs": {
    "market_cap": 3095205888115.68,
    "price": 411.74,
    "fiscal_year": "2025",
    "revenue": 281724000000,
    "net_income": 101832000000,
    "equity": 343479000000
  },
  "disclaimer": "Factual quantitative analysis, not investment advice. Inputs are delayed/periodic; verify before acting."
}
GET/api/v1/portfolio/xray$0.25

Portfolio risk x-ray: concentration, sector & market-cap exposure, and weighted performance in one call

Risk x-ray for a whole watchlist or portfolio in one call. Pass `?tickers=AAPL,MSFT,NVDA` (up to 25; optional `?weights=`). Returns per-holding price, sector and cap, plus portfolio concentration (top-weight, Herfindahl, diversification score), sector concentration, market-cap distribution, weighted day performance and risk flags. Replaces dozens of per-holding calls.

Example request
GET /api/v1/portfolio/xray
Response type (TypeScript)
interface PortfolioXrayResponse {
  source: string;
  as_of: string;
  holding_count: number;
  weighting: string;
  sections: {
    prices: string;
    profiles: string;
  };
  summary: {
    day_change_percent: number;
    sector_concentration: {
      hhi: number;
      label: string;
      coverage: number;
      top_sectors: Array<{
        sector: string;
        weight: number;
      }>;
    };
    market_cap_distribution: {
      mega: number;
      large: number;
      mid: number;
      small: number;
      micro: number;
      unknown: number;
    };
    concentration: {
      top_weight: number;
      top3_weight: number;
      hhi: number;
      diversification_score: number;
      label: string;
    };
    performance: {
      best: {
        ticker: string;
        change_percent: number;
      };
      worst: {
        ticker: string;
        change_percent: number;
      };
    };
    risk_flags: string[];
  };
  holdings: Array<{
    ticker: string;
    name: string;
    price: number;
    change_percent: number;
    market_cap: number;
    sector: string;
    cap_bucket: string;
    weight: number;
  }>;
  disclaimer: string;
}
Example response (click to expand)
{
  "source": "x402stock",
  "as_of": "2026-06-09T04:28:08.242Z",
  "holding_count": 4,
  "weighting": "equal",
  "sections": {
    "prices": "ok",
    "profiles": "ok"
  },
  "summary": {
    "day_change_percent": -0.657,
    "sector_concentration": {
      "hhi": 0.25,
      "label": "diversified",
      "coverage": 1,
      "top_sectors": [
        {
          "sector": "ELECTRONIC COMPUTERS",
          "weight": 0.25
        },
        {
          "sector": "SERVICES-PREPACKAGED SOFTWARE",
          "weight": 0.25
        },
        {
          "sector": "SEMICONDUCTORS & RELATED DEVICES",
          "weight": 0.25
        },
        {
          "sector": "NATIONAL COMMERCIAL BANKS",
          "weight": 0.25
        }
      ]
    },
    "market_cap_distribution": {
      "mega": 1,
      "large": 0,
      "mid": 0,
      "small": 0,
      "micro": 0,
      "unknown": 0
    },
    "concentration": {
      "top_weight": 0.25,
      "top3_weight": 0.75,
      "hhi": 0.25,
      "diversification_score": 75,
      "label": "moderate"
    },
    "performance": {
      "best": {
        "ticker": "NVDA",
        "change_percent": 1.243
      },
      "worst": {
        "ticker": "AAPL",
        "change_percent": -2.16
      }
    },
    "risk_flags": [
      "few_holdings"
    ]
  },
  "holdings": [
    {
      "ticker": "AAPL",
      "name": "Apple Inc.",
      "price": 300.7,
      "change_percent": -2.16,
      "market_cap": 4514011993040,
      "sector": "ELECTRONIC COMPUTERS",
      "cap_bucket": "mega",
      "weight": 0.25
    },
    {
      "ticker": "MSFT",
      "name": "Microsoft Corp",
      "price": 410.9799,
      "change_percent": -1.37,
      "market_cap": 3095205888115.68,
      "sector": "SERVICES-PREPACKAGED SOFTWARE",
      "cap_bucket": "mega",
      "weight": 0.25
    },
    {
      "ticker": "NVDA",
      "name": "Nvidia Corp",
      "price": 207.65,
      "change_percent": 1.243,
      "market_cap": 4967727100000,
      "sector": "SEMICONDUCTORS & RELATED DEVICES",
      "cap_bucket": "mega",
      "weight": 0.25
    },
    {
      "ticker": "JPM",
      "name": "JPMorgan Chase & Co.",
      "price": 311.3,
      "change_percent": -0.343,
      "market_cap": 836998981640.66,
      "sector": "NATIONAL COMMERCIAL BANKS",
      "cap_bucket": "mega",
      "weight": 0.25
    }
  ],
  "disclaimer": "Factual quantitative analysis, not investment advice. Inputs are delayed/periodic; verify before acting."
}
GET/api/v1/screener/smart$0.20

Natural-language stock screener: describe what you want, get a ranked shortlist with per-name rationale

Describe a screen in plain English via `?q=` (e.g. 'oversold large caps up today on high volume'). An LLM parses it into a filter, screens the entire US market, optionally confirms oversold/overbought with RSI, and returns a ranked shortlist with a one-line rationale per name. No need to know the filter schema or run the enrichment loop yourself.

Example request
GET /api/v1/screener/smart
Response type (TypeScript)
interface SmartScreenerResponse {
  query: string;
  source: string;
  as_of: string;
  interpretation: string;
  note: null;
  filter: {
    min_price: number;
    max_price: null;
    min_change_percent: number;
    max_change_percent: null;
    min_volume: null;
    sort: string;
    order: string;
    limit: number;
    signal: string;
  };
  sections: {
    filter: string;
    market: string;
    rationale: string;
  };
  result_count: number;
  results: Array<{
    ticker: string;
    price: number;
    change_percent: number;
    volume: number;
    rsi: null;
    rationale: string;
  }>;
  summary: string;
  model: string;
  disclaimer: string;
}
Example response (click to expand)
{
  "query": "large caps over $100 up at least 3% today on high volume",
  "source": "x402stock",
  "as_of": "2026-06-09T04:28:40.092Z",
  "interpretation": "Screening for large cap stocks priced over $100 that are up at least 3% today.",
  "note": null,
  "filter": {
    "min_price": 100,
    "max_price": null,
    "min_change_percent": 3,
    "max_change_percent": null,
    "min_volume": null,
    "sort": "change_percent",
    "order": "desc",
    "limit": 15,
    "signal": "none"
  },
  "sections": {
    "filter": "ok",
    "market": "ok",
    "rationale": "ok"
  },
  "result_count": 15,
  "results": [
    {
      "ticker": "LINT",
      "price": 165.36,
      "change_percent": 20.868357576200577,
      "volume": 244307,
      "rsi": null,
      "rationale": "LINT is priced at $165.36 and is up 20.87% today with a volume of 244,307, indicating strong market interest."
    },
    {
      "ticker": "MUU",
      "price": 799,
      "change_percent": 20.817141215429505,
      "volume": 3920951,
      "rsi": null,
      "rationale": "MUU, with a price of $799, has risen by 20.82% today and has a high volume of 3,920,951, reflecting significant trading activity."
    },
    {
      "ticker": "INTW",
      "price": 261.33,
      "change_percent": 20.684400110834023,
      "volume": 1077302,
      "rsi": null,
      "rationale": "INTW is trading at $261.33, up 20.68% today on a volume of 1,077,302, showing robust investor demand."
    },
    {
      "ticker": "CBRS",
      "price": 240.5416,
      "change_percent": 19.666484254514703,
      "volume": 8691312,
      "rsi": null,
      "rationale": "CBRS is priced at $240.54 and has increased by 19.67% today with a volume of 8,691,312, suggesting strong market momentum."
    },
    {
      "ticker": "KEEX",
      "price": 113.64,
      "change_percent": 19.64624131396083,
      "volume": 18829,
      "rsi": null,
      "rationale": "KEEX, at $113.64, is up 19.65% today but has a lower volume of 18,829, indicating less trading activity compared to others."
    },
    {
      "ticker": "MULL",
      "price": 690,
      "change_percent": 19.170984455958543,
      "volume": 504960,
      "rsi": null,
      "rationale": "MULL is priced at $690 and has gained 19.17% today with a volume of 504,960, demonstrating solid interest."
    },
    {
      "ticker": "LABX",
      "price": 123.1,
      "change_percent": 19.058295964125556,
      "volume": 228111,
      "rsi": null,
      "rationale": "LABX, with a price of $123.10, is up 19.06% today on a volume of 228,111, indicating positive market sentiment."
    },
    {
      "ticker": "MRVU",
      "price": 231,
      "change_percent": 18.3159188690842,
      "volume": 674182,
      "rsi": null,
      "rationale": "MRVU is trading at $231, up 18.32% today with a volume of 674,182, reflecting strong buying pressure."
    },
    {
      "ticker": "MVLL",
      "price": 173.5,
      "change_percent": 16.764250622518336,
      "volume": 5551503,
      "rsi": null,
      "rationale": "MVLL, priced at $173.50, has increased by 16.76% today with a volume of 5,551,503, showing significant trading activity."
    },
    {
      "ticker": "KORU",
      "price": 724.99,
      "change_percent": 16.29973279126573,
      "volume": 1758437,
      "rsi": null,
      "rationale": "KORU is priced at $724.99 and is up 16.30% today with a volume of 1,758,437, indicating strong investor interest."
    },
    {
      "ticker": "SOXL",
      "price": 211.3,
      "change_percent": 15.832146378875866,
      "volume": 68158234,
      "rsi": null,
      "rationale": "SOXL, at $211.30, has risen by 15.83% today on a very high volume of 68,158,234, suggesting exceptional market activity."
    },
    {
      "ticker": "VCX",
      "price": 154.52,
      "change_percent": 12.796554493028689,
      "volume": 177737,
      "rsi": null,
      "rationale": "VCX is priced at $154.52 and is up 12.80% today with a volume of 177,737, indicating positive market movement."
    },
    {
      "ticker": "SYNA",
      "price": 137.86,
      "change_percent": 12.282130640169418,
      "volume": 1148779,
      "rsi": null,
      "rationale": "SYNA, with a price of $137.86, is up 12.28% today on a volume of 1,148,779, reflecting solid investor interest."
    },
    {
      "ticker": "AAOI",
      "price": 196.0591,
      "change_percent": 10.767853107344632,
      "volume": 14905710,
      "rsi": null,
      "rationale": "AAOI is priced at $196.06 and has increased by 10.77% today with a volume of 14,905,710, indicating strong market demand."
    },
    {
      "ticker": "INTC",
      "price": 109.8199,
      "change_percent": 10.739033982051026,
      "volume": 136995208,
      "rsi": null,
      "rationale": "INTC, at $109.82, is up 10.74% today with a high volume of 136,995,208, showing significant trading activity."
    }
  ],
  "summary": "The shortlist includes several large-cap stocks priced over $100 that have increased by at least 3% today on high trading volume.",
  "model": "gpt-4o-mini",
  "disclaimer": "AI-assisted screen over delayed whole-market data, not investment advice."
}