# x402stock FDA Data API

> x402stock FDA Data API is a paid API for AI agents from x402stock.xyz, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-24).

Returns FDA drug recalls, drug approvals, device approvals, and device clearances for a named company, paid per-call in USDC via x402

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/fda?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-24
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-fda-data-api-28d3fe63
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Ao6sI9sAr0Xw5yLmLpdj_

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-fda-data-api-28d3fe63
```

Example prompt: Pull the FDA drug recalls, drug approvals, device approvals, and device clearances for Medtronic — show me up to 10 results per category.

## When to prefer this

Use this endpoint when an AI agent needs structured, aggregated FDA regulatory data — recalls, approvals, and clearances — for a specific company without managing API keys or subscriptions. It is ideal for financial analysis of pharma/medtech stocks, due diligence workflows, compliance checks, or news enrichment. Prefer over direct openFDA queries when you want company-centric aggregation across multiple FDA databases in one call, and pay only per request.

## Known failure modes

- Unknown or misspelled company name returns empty result sets with total_matched 0
- limit parameter out of range (<=0 or >50) causes validation error
- Company name too short (<2 chars) or too long (>120 chars) causes input validation failure
- FDA upstream (openFDA) unavailable causes 5xx or timeout
- Payment not confirmed via x402 returns 402 Payment Required

## How this service works

FDA catalysts for a pharma/biotech/medtech company, from openFDA. Pass `?company=Medtronic` (required) plus `?limit=` (max 50). Returns `drug` (recalls + approvals) and `device` (510(k) clearances, PMA approvals, recalls) sections, each with recent items, match totals, and official FDA links. One call across 5 FDA datasets. From x402stock, a market & economic data API (x402, USDC).

## Output

A JSON object containing the company name, timestamp, and four data buckets: drug recalls (with date, status, classification, product description, recall reason, firm, recall number, voluntary/mandated flag), drug approvals, device PMA approvals (with applicant, PMA number, trade name, generic name, decision date, supplement type, advisory committee), and device 510k clearances (with K-number, applicant, device name, decision, dates, advisory committee). Each bucket reports count and total_matched.

## Request schema (JSON Schema)

```json
{
 "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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "company",
      "limit"
     ],
     "properties": {
      "limit": {
       "type": "integer",
       "default": 10,
       "maximum": 50,
       "exclusiveMinimum": 0
      },
      "company": {
       "type": "string",
       "maxLength": 120,
       "minLength": 2
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "source",
      "as_of",
      "company",
      "drug",
      "device",
      "attribution"
     ],
     "properties": {
      "drug": {
       "type": "object",
       "required": [
        "recalls",
        "approvals"
       ],
       "properties": {
        "recalls": {
         "type": "object",
         "required": [
          "total_matched",
          "count",
          "items"
         ],
         "properties": {
          "count": {
           "type": "number"
          },
          "items": {
           "type": "array",
           "items": {
            "type": "object",
            "required": [
             "date",
             "status",
             "classification",
             "product_type",
             "product_description",
             "reason",
             "firm",
             "recall_number",
             "voluntary_mandated"
            ],
            "properties": {
             "date": {
              "anyOf": [
               {
                "type": "string"
               },
               {
                "type": "null"
               }
              ]
             },
             "firm": {
              "anyOf": [
               {
                "type": "string"
               },
               {
                "type": "null"
               }
              ]
             },

… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "drug": {
   "recalls": {
    "count": 0,
    "items": [],
    "total_matched": 0
   },
   "approvals": {
    "count": 0,
    "items": [],
    "total_matched": 0
   }
  },
  "as_of": "2026-06-18T12:00:00.000Z",
  "device": {
   "recalls": {
    "count": 0,
    "items": [],
    "total_matched": 1250
   },
   "approvals": {
    "count": 1,
    "items": [
     {
      "url": "https://www.accessdata.fda.gov/scripts/cdrh/cfdocs/cfpma/pma.cfm?id=P160043",
      "applicant": "Medtronic Vascular",
      "pma_number": "P160043",
      "trade_name": "Resolute Onyx Zotarolimus-Eluting Coronary Stent System",
      "generic_name": "Coronary drug-eluting stent",
      "product_code": "NIQ",
      "decision_code": "OK30",
      "decision_date": "2026-06-05",
      "supplement_type": "30-Day Notice",
      "supplement_number": "S094",
      "advisory_committee": "Cardiovascular"
     }
    ],
    "total_matched": 12772
   },
   "clearances": {
    "count": 1,
    "items": [
     {
      "url": "https://www.accessdata.fda.gov/scripts/cdrh/cfdocs/cfpmn/pmn.cfm?ID=K253656",
      "decision": "Substantially Equivalent",
      "k_number": "K253656",
      "applicant": "Medtronic Sofamor Danek USA, Inc.",
      "device_name": "OsteoCool RF Ablation System; OsteoCool 2.0 RF Ablation System",
      "product_code": "GEI",
      "date_received": "2025-11-20",
      "decision_date": "2026-06-05",
      "clearance_type": "Traditional",
      "advisory_committee": "General, Plastic Surgery"
     }
    ],
    "total_matched": 1576
   }
  },
  "source": "fda",
  "company": "Medtronic",
  "attribution": "Source: openFDA, U.S. Food and Drug Administration"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-fda-data-api-28d3fe63/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)
