{
  "openapi": "3.1.0",
  "info": {
    "title": "ClinicalIntelPulse API",
    "description": "Pharmaceutical pipeline and clinical trial intelligence API. Synthesizes 400,000+ registered trials from ClinicalTrials.gov with FDA OpenFDA, PubMed, and real-time news. All endpoints require x402 payment (USDC on Base mainnet) via the PAYMENT-SIGNATURE header.",
    "version": "1.0.0",
    "contact": {
      "name": "The Aslan Group LLC",
      "url": "https://pulsenetwork.theaslangroupllc.com",
      "email": "info@theaslangroupllc.com"
    },
    "x-guidance": "# ClinicalIntelPulse API (x402 pay-per-call)\n\nThe medical intelligence layer for AI agents. Consumer lane: plain-language drug info, drug-drug interaction screening, and recall checks from FDA-approved labels (drug-check, interaction-check, recall-check). Institutional lane: pharmaceutical pipeline and clinical-trial intelligence from 400,000+ ClinicalTrials.gov studies, FDA OpenFDA, and PubMed. 13 endpoints, from $0.10. Pay-per-query via x402 micropayments on Base.\n\nBase URL: https://clinicalintelpulse.theaslangroupllc.com\n\n## Payment\nAll paid endpoints use the x402 protocol (HTTP 402): USDC on Base mainnet (eip155:8453). No API keys, no accounts, no subscriptions — pay per call.\n\n## Agent workflow\n1. Request the endpoint. Unpaid requests receive a 402 challenge with exact price and pay-to details (the challenge is returned before request validation).\n2. Settle with any x402 client (agentcash fetch, x402-fetch, x402-axios) and retry with the X-PAYMENT header.\n3. Responses are JSON. Prices below are fixed per call.\n\n## Paid endpoints\n- GET /api/clinical/trial-check — $0.02 — ClinicalTrials.gov lookup — single trial by NCT id or filtered search, deterministic — Trial status, phase, sponsor, enrollment, dates and countries by NCT id, \n- GET /api/clinical/pipeline-scan — $0.15 — Phase 2/3 trial count, sponsor landscape, geographic distribution, mechanism breakdown for any disease.\n- GET /api/clinical/approval-outlook — $0.25 — FDA/EMA approval probability — PDUFA calendar, success rates, regulatory designations.\n- GET /api/clinical/sponsor-intel — $0.2 — Full pipeline by phase, FDA approvals, Phase 3 assets, partnerships for any pharma/biotech company.\n- GET /api/clinical/disease-landscape — $0.35 — Comprehensive disease brief — approved drugs, mechanism gaps, pipeline map, PDUFA, deals, opportunity score 0-100. Replaces Evaluate Pharma.\n- GET /api/clinical/trial-brief — $0.1 — Full design, endpoints, eligibility, enrollment, outcome for any trial by NCT ID.\n- GET /api/clinical/mechanism-map — $0.2 — Approved MOAs, pipeline targets, first-in-class opportunities, white spaces, modality breakdown.\n- GET /api/clinical/global-trials — $0.15 — WHO ICTRP registry coverage — ChiCTR, CTRI, UMIN, REBEC, ANZCTR, KCT + regional regulatory landscape.\n- GET /api/clinical/failure-analysis — $0.2 — Phase 2→3 and Phase 3→approval success rates, failure taxonomy, named failed trials, lessons for new programs.\n- GET /api/clinical/patient-finder — $0.1 — Plain-language recruiting trial finder for patients — accessible eligibility, application guide, advocacy resources.\n- GET /api/clinical/deal-signal — $0.35 — Biotech M&A signals — acquisition targets with deal values, recent comps, likely acquirers, timing signals.\n- GET /api/clinical/drug-check — $0.1 — What is this medication? (plain language) — Plain-language explainer for any prescription or OTC drug from its FDA-approved label — what it treats, how to take \n- GET /api/clinical/interaction-check — $0.15 — Can these medications be taken together? — Cross-references the FDA-approved drug-interaction and contraindication sections for 2+ drugs and flags possible inte\n- GET /api/clinical/recall-check — $0.1 — Is my medication recalled? — Checks the FDA enforcement database for active and past recalls of a drug, explains the recall class (I/II/III) in plain language, \n\nMore APIs from this provider: https://pulsenetwork.theaslangroupllc.com (grouped catalog, all x402)."
  },
  "servers": [
    {
      "url": "https://clinicalintelpulse.theaslangroupllc.com"
    }
  ],
  "components": {
    "parameters": {
      "condition": {
        "name": "condition",
        "in": "query",
        "required": false,
        "schema": {
          "type": "string"
        },
        "description": "Disease or condition — e.g. 'Non-Small Cell Lung Cancer' | 'Alzheimer Disease' | 'Type 2 Diabetes'"
      },
      "lang": {
        "name": "lang",
        "in": "query",
        "required": false,
        "schema": {
          "type": "string",
          "enum": [
            "en",
            "es",
            "fr",
            "de",
            "ja",
            "zh",
            "ko",
            "pt",
            "ar",
            "hi"
          ],
          "default": "en"
        },
        "description": "Response language"
      }
    }
  },
  "paths": {
    "/api/clinical/trial-check": {
      "get": {
        "summary": "ClinicalTrials.gov lookup — single trial by NCT id or filtered search, deterministic",
        "description": "Trial status, phase, sponsor, enrollment, dates and countries by NCT id, or search by condition/sponsor with phase and status filters. Typed records straight off the official v2 API. No LLM, public domain.",
        "parameters": [
          {
            "name": "nct",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Single trial by NCT id, e.g. NCT02142738"
          },
          {
            "name": "condition",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Search by condition"
          },
          {
            "name": "sponsor",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Search by sponsor"
          },
          {
            "name": "phase",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "1|2|3|4"
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "RECRUITING | COMPLETED | ..."
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "1-25, default 10"
          }
        ],
        "responses": {
          "200": {
            "description": "Deterministic typed result"
          },
          "402": {
            "description": "Payment required - x402 USDC on Base."
          },
          "502": {
            "description": "Upstream unavailable - reported, never disguised as an empty result"
          }
        },
        "x-price-usd": 0.02,
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.020000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/api/clinical/pipeline-scan": {
      "get": {
        "summary": "Phase 2/3 pipeline scan",
        "description": "All active Phase 2/3 trials for any disease globally — trial counts, sponsor landscape, geographic distribution, mechanism breakdown, pipeline density assessment. Data: ClinicalTrials.gov v2 (no API key required).",
        "operationId": "pipelineScan",
        "parameters": [
          {
            "$ref": "#/components/parameters/condition"
          },
          {
            "name": "phase",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "phase2",
                "phase3",
                "both"
              ],
              "default": "both"
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "active",
                "all"
              ],
              "default": "active"
            }
          },
          {
            "$ref": "#/components/parameters/lang"
          }
        ],
        "responses": {
          "200": {
            "description": "Pipeline scan"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.15,
        "x-agent-use-case": "on-demand",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.150000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/api/clinical/approval-outlook": {
      "get": {
        "summary": "FDA/EMA approval probability",
        "description": "Approval probability for drugs in a disease area — PDUFA calendar, completed trial data, regulatory designations, historical success rates. Data: ClinicalTrials.gov + FDA OpenFDA + PDUFA synthesis.",
        "operationId": "approvalOutlook",
        "parameters": [
          {
            "$ref": "#/components/parameters/condition"
          },
          {
            "name": "horizon",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "12m",
                "18m",
                "24m"
              ],
              "default": "18m"
            }
          },
          {
            "name": "agency",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "FDA",
                "EMA",
                "both"
              ],
              "default": "both"
            }
          },
          {
            "$ref": "#/components/parameters/lang"
          }
        ],
        "responses": {
          "200": {
            "description": "Approval outlook"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.25,
        "x-agent-use-case": "on-demand",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.250000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/api/clinical/sponsor-intel": {
      "get": {
        "summary": "Pharma/biotech pipeline intelligence",
        "description": "Pipeline by phase, FDA approval history, Phase 3 assets with peak sales estimates, partnerships, investment signals for any company. Data: ClinicalTrials.gov + FDA OpenFDA + news synthesis.",
        "operationId": "sponsorIntel",
        "parameters": [
          {
            "name": "sponsor",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Company name — e.g. 'Moderna' | 'Alnylam' | 'Vertex Pharmaceuticals'"
          },
          {
            "name": "focus",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "pipeline",
                "approvals",
                "deals",
                "all"
              ],
              "default": "all"
            }
          },
          {
            "$ref": "#/components/parameters/lang"
          }
        ],
        "responses": {
          "200": {
            "description": "Sponsor intelligence"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.2,
        "x-agent-use-case": "on-demand",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.200000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/api/clinical/disease-landscape": {
      "get": {
        "summary": "Full disease landscape report",
        "description": "Comprehensive disease brief — approved drugs, mechanism landscape (crowded/gaps), Phase 2-3 pipeline, PDUFA calendar, M&A deal activity, opportunity score (0-100), investment thesis. Replaces Evaluate Pharma/Citeline.",
        "operationId": "diseaseLandscape",
        "parameters": [
          {
            "$ref": "#/components/parameters/condition"
          },
          {
            "name": "depth",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "standard",
                "deep"
              ],
              "default": "standard"
            }
          },
          {
            "$ref": "#/components/parameters/lang"
          }
        ],
        "responses": {
          "200": {
            "description": "Disease landscape"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.35,
        "x-agent-use-case": "on-demand",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.350000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/api/clinical/disease-landscape-lite": {
      "get": {
        "summary": "Disease landscape — $0.25 deterministic preview",
        "description": "Numbers-only preview of disease-landscape: Phase 2/3 trial counts, sponsor rollup, trial-status breakdown, sample trials — straight off ClinicalTrials.gov, no LLM synthesis. Upsell to the full report for approved drugs, mechanism landscape, PDUFA calendar, deal activity and opportunity score.",
        "operationId": "diseaseLandscapeLite",
        "parameters": [
          {
            "$ref": "#/components/parameters/condition"
          }
        ],
        "responses": {
          "200": {
            "description": "Deterministic disease pipeline preview"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.25,
        "x-agent-use-case": "on-demand",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.250000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/api/clinical/trial-brief": {
      "get": {
        "summary": "Clinical trial deep dive by NCT ID",
        "description": "Full trial design, endpoints, eligibility, enrollment, geographic footprint, outcome summary for any trial by NCT ID. Data: ClinicalTrials.gov v2 + PubMed.",
        "operationId": "trialBrief",
        "parameters": [
          {
            "name": "nct_id",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "NCT identifier — e.g. NCT04368728"
          },
          {
            "$ref": "#/components/parameters/lang"
          }
        ],
        "responses": {
          "200": {
            "description": "Trial brief"
          },
          "400": {
            "description": "Invalid NCT ID"
          },
          "402": {
            "description": "Payment required"
          },
          "404": {
            "description": "Trial not found"
          }
        },
        "x-price-usd": 0.1,
        "x-agent-use-case": "on-demand",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.100000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/api/clinical/mechanism-map": {
      "get": {
        "summary": "Drug target and MOA landscape",
        "description": "Approved mechanisms, pipeline targets by phase, first-in-class opportunities, white spaces (validated biology, no agent), modality breakdown, combination landscape. Data: ClinicalTrials.gov + PubMed + synthesis.",
        "operationId": "mechanismMap",
        "parameters": [
          {
            "$ref": "#/components/parameters/condition"
          },
          {
            "name": "mechanism",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Optional focus — e.g. 'BTK inhibitor' | 'CAR-T' | 'IL-17'"
          },
          {
            "$ref": "#/components/parameters/lang"
          }
        ],
        "responses": {
          "200": {
            "description": "Mechanism map"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.2,
        "x-agent-use-case": "on-demand",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.200000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/api/clinical/global-trials": {
      "get": {
        "summary": "Global clinical trial landscape",
        "description": "International distribution across WHO ICTRP registries — ChiCTR/China, CTRI/India, UMIN/Japan, REBEC/Brazil, ANZCTR/Australia, KCT/Korea, and 10+ more. Regional regulatory landscape, unmet needs, development finance context.",
        "operationId": "globalTrials",
        "parameters": [
          {
            "$ref": "#/components/parameters/condition"
          },
          {
            "name": "region",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "global",
                "africa",
                "asia",
                "europe",
                "latin-america",
                "middle-east",
                "north-america"
              ],
              "default": "global"
            }
          },
          {
            "$ref": "#/components/parameters/lang"
          }
        ],
        "responses": {
          "200": {
            "description": "Global trial landscape"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.15,
        "x-agent-use-case": "on-demand",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.150000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/api/clinical/failure-analysis": {
      "get": {
        "summary": "Clinical trial failure analysis",
        "description": "Phase 2→3 and Phase 3→approval success rates, failure taxonomy (wrong hypothesis/patient/endpoint/dose/safety), named failed trials, lessons learned, successful design principles, biomarker strategy.",
        "operationId": "failureAnalysis",
        "parameters": [
          {
            "$ref": "#/components/parameters/condition"
          },
          {
            "$ref": "#/components/parameters/lang"
          }
        ],
        "responses": {
          "200": {
            "description": "Failure analysis"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.2,
        "x-agent-use-case": "on-demand",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.200000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/api/clinical/patient-finder": {
      "get": {
        "summary": "Recruiting trial finder (plain language)",
        "description": "Patient-friendly finder — recruiting trials with plain-language summaries, accessible eligibility, step-by-step application guide, patient advocacy resources. Global coverage. Data: ClinicalTrials.gov v2.",
        "operationId": "patientFinder",
        "parameters": [
          {
            "$ref": "#/components/parameters/condition"
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Optional country filter — e.g. 'United States' | 'Germany' | 'Australia'"
          },
          {
            "name": "phase",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "phase2",
                "phase3",
                "any"
              ],
              "default": "any"
            }
          },
          {
            "$ref": "#/components/parameters/lang"
          }
        ],
        "responses": {
          "200": {
            "description": "Patient finder results"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.1,
        "x-agent-use-case": "on-demand",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.100000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/api/clinical/deal-signal": {
      "get": {
        "summary": "Biotech M&A and licensing deal signals",
        "description": "Acquisition targets with estimated deal values, recent deal comps (named transactions + dollar values), most likely acquirers, deal timing signals, valuation framework, red flags.",
        "operationId": "dealSignal",
        "parameters": [
          {
            "$ref": "#/components/parameters/condition"
          },
          {
            "name": "deal_type",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "acquisition",
                "licensing",
                "both"
              ],
              "default": "both"
            }
          },
          {
            "name": "stage",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "phase2",
                "phase3",
                "both"
              ],
              "default": "both"
            }
          },
          {
            "$ref": "#/components/parameters/lang"
          }
        ],
        "responses": {
          "200": {
            "description": "Deal signal report"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.35,
        "x-agent-use-case": "on-demand",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.350000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/api/clinical/deal-signal-lite": {
      "get": {
        "summary": "Deal signal — $0.25 deterministic preview",
        "description": "Numbers-only preview of deal-signal: Phase 2/3 trial counts and the industry-sponsored candidate-asset list — straight off ClinicalTrials.gov, no LLM synthesis. Upsell to the full report for acquisition rationale, deal comps with dollar values, likely acquirers and timing signals.",
        "operationId": "dealSignalLite",
        "parameters": [
          {
            "$ref": "#/components/parameters/condition"
          },
          {
            "name": "stage",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "phase2",
                "phase3",
                "both"
              ],
              "default": "both"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Deterministic deal-signal candidate preview"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.25,
        "x-agent-use-case": "on-demand",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.250000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/api/clinical/drug-check": {
      "get": {
        "summary": "What is this medication? (plain language)",
        "description": "Plain-language explainer for any prescription or OTC drug from its FDA-approved label — what it treats, how to take it, boxed warnings, who should not take it, common and serious side effects, pregnancy notes. Data: FDA openFDA drug label.",
        "operationId": "drugCheck",
        "parameters": [
          {
            "name": "drug",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Brand or generic medication name — e.g. 'Ozempic' | 'metformin' | 'ibuprofen'"
          },
          {
            "$ref": "#/components/parameters/lang"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.1,
        "x-agent-use-case": "on-demand",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.100000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/api/clinical/interaction-check": {
      "get": {
        "summary": "Can these medications be taken together?",
        "description": "Cross-references the FDA-approved drug-interaction and contraindication sections for 2+ drugs and flags possible interactions in plain language, with severity and what-to-do. Data: FDA openFDA drug label.",
        "operationId": "interactionCheck",
        "parameters": [
          {
            "name": "drugs",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Two to eight medication names, comma-separated — e.g. 'warfarin,ibuprofen'"
          },
          {
            "$ref": "#/components/parameters/lang"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.15,
        "x-agent-use-case": "on-demand",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.150000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/api/clinical/recall-check": {
      "get": {
        "summary": "Is my medication recalled?",
        "description": "Checks the FDA enforcement database for active and past recalls of a drug, explains the recall class (I/II/III) in plain language, and lays out what to do. Data: FDA openFDA enforcement.",
        "operationId": "recallCheck",
        "parameters": [
          {
            "name": "drug",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Brand or generic medication name — e.g. 'metformin' | 'valsartan'"
          },
          {
            "$ref": "#/components/parameters/lang"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.1,
        "x-agent-use-case": "on-demand",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.100000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    }
  }
}