# x402stock Insider Conviction Score API

> x402stock Insider Conviction Score API is a paid API for AI agents from x402stock.xyz, paid per call via x402, $0.15/call, status healthy (last checked 2026-09-14, last successful call 2026-08-31).

Returns a scored insider trading sentiment signal (0-100) for a US stock ticker based on SEC Form-4 filings, Form 144 notices, and 13D/13G beneficial ownership data.

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/score/insider/%7Bticker%7D
- Price: $0.15/call
- Payment: x402
- Status: healthy
- Last checked: 2026-09-14
- Last successful call: 2026-08-31
- Success rate: 100% of calls made through Zero
- Rating: 4.7 / 5 from 1 review
- Activations on Zero: 1
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-insider-conviction-score-api-bb997912
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0RVetPWHDeLoSgsL-HowE

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability x402stock-insider-conviction-score-api-bb997912
```

Example prompt: What's the insider conviction score for NVDA right now — are insiders net buying or selling, and what's dragging the score up or down?

## When to prefer this

Use this endpoint when you need a quantitative, multi-factor insider sentiment score for a specific US stock, synthesizing Form-4 open-market trades, Form 144 sell notices, role-weighted C-suite activity, cluster buying signals, and activist 13D stakes into a single 0-100 score. Prefer over raw SEC EDGAR scraping when you want a pre-computed, interpretable conviction signal rather than raw filing data. No API key or account required — pay per call in USDC.

## Known failure modes

- Unknown or delisted ticker returns an error or empty result
- No recent SEC filings may result in low confidence score
- Delayed/periodic data may not reflect very recent trades
- Invalid ticker format (e.g. non-alphanumeric) returns a 400 error
- Payment failure or insufficient USDC balance blocks the request via x402

## How this service works

Pay-per-call market and economic data API for AI agents: US stocks, ETFs and options, forex, crypto and on-chain perps, energy commodities, US and global macro (Fed, CPI, jobs, GDP, Treasury, World Bank), SEC filings, congressional trades, and market sentiment. No API keys, no accounts. Pay per request in USDC via x402 on Base.

## Output

A JSON object containing: a 0-100 conviction score with a label (e.g. 'buying' or 'selling'), a breakdown of score factors (net share flow, role-weighted activity, cluster buying, Form 144 overhang, activist 13D), raw inputs (open-market buy/sell counts, net shares, Form 144 notices, Schedule 13 filings), a plain-English rationale, a confidence value, and the as-of timestamp. Costs $0.15 USDC per call via x402 on Base.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "as_of": "2026-06-08T12:00:00.000Z",
  "score": {
   "max": 100,
   "label": "buying",
   "value": 63,
   "factors": [
    {
     "name": "net_flow",
     "label": "Net open-market (P/S) buy/sell share flow",
     "detail": {
      "open_buys": 4,
      "net_shares": 18000,
      "open_sells": 1
     },
     "points": 12
    },
    {
     "name": "role_weighted",
     "label": "Role-weighted open-market activity (C-suite/10% owners weigh more)",
     "points": 6
    },
    {
     "name": "cluster",
     "label": "Cluster buying (distinct insiders buying)",
     "detail": {
      "distinct_buyers": 2
     },
     "points": 4
    },
    {
     "name": "intent_to_sell",
     "label": "Form 144 intent-to-sell overhang",
     "detail": {
      "notices": 2,
      "aggregate_value": 4200000
     },
     "points": -9
    },
    {
     "name": "activist_13d",
     "label": "Activist 13D stake on file",
     "detail": {
      "has_13d": false,
      "schedule_13_count": 1
     },
     "points": 0
    }
   ],
   "baseline": 50,
   "confidence": 1
  },
  "inputs": {
   "open_market": {
    "buys": 4,
    "sells": 1,
    "net_shares": 18000,
    "shares_sold": 2000,
    "shares_bought": 20000
   },
   "form144_notices": 2,
   "reported_summary": {
    "buys": 5,
    "sells": 1,
    "signal": "net_buying",
    "net_shares": 20000,
    "shares_sold": 2000,
    "shares_bought": 22000
   },
   "schedule_13_filings": 1
  },
  "source": "x402stock",
  "ticker": "AAPL",
  "sections": {
   "form_144": "ok",
   "insider_trades": "ok",
   "beneficial_ownership": "ok"
  },
  "rationale": "AAPL scores 63/100 (buying) for insider conviction. 4 open-market buys vs 1 sells. 2 distinct insiders buying on the open market. 2 Form 144 sell notice(s) pending.",
  "disclaimer": "Factual quantitative analysis, not investment advice. Inputs are delayed/periodic; verify before acting.",
  "methodology": "Starts at a neutral 50, then adjusts for net Form-4 share flow (±30), role-weighted activity (±15), cluster buying (+12), Form 144 intent-to-sell overhang (−15), and an activist 13D stake (+5)."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-insider-conviction-score-api-bb997912/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402stock.xyz](https://www.zero.xyz/host/x402stock.xyz/llms.txt)