# Decision Data Studio — Clinical Trials Query

> Decision Data Studio — Clinical Trials Query is a paid API for AI agents from api.ikoles.dev, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Queries the ClinicalTrials.gov registry to return structured trial records filtered by condition, intervention, phase, status, and date range.

## Facts

- Endpoint: POST https://api.ikoles.dev/v1/clinical-trials-query
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/decision-data-studio-clinical-trials-query-01d0690a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_eSWjVSS6lxu076OAknDXe

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 decision-data-studio-clinical-trials-query-01d0690a -d '<json body>'
```

Example prompt: Search ClinicalTrials.gov for up to 10 completed phase 3 trials studying metformin for type 2 diabetes that have posted results since January 2022, and give me the trial IDs, titles, and primary endpoints.

## When to prefer this

Choose this endpoint when you need structured, machine-readable access to ClinicalTrials.gov data filtered by condition, intervention, phase, or status without scraping the web UI. It is ideal for agents doing biomedical research, competitive intelligence, patient advocacy lookups, or evidence synthesis pipelines where you need trial IDs, endpoints, and enrollment data in a single call. Prefer this over general web search when you need reliable, structured fields like enrollment counts, primary endpoints, and result post dates.

## Known failure modes

- No trials match the specified filters — returns empty trials array with zero matchedTrials
- Query or condition string exceeds 200-character limit — validation error
- Phase or overallStatus value not recognized by the registry — may return zero results
- Limit out of range (below 1 or above 20) — validation error
- Date format incorrect (not ISO 8601 YYYY-MM-DD) — schema validation failure
- Upstream ClinicalTrials.gov data unavailable — service may return error or stale dataset version

## How this service works

Local-first data and agent workflow tools from Decision Data Studio, plus verified EU tender shortlists and machine-callable utilities.

## Output

Returns a JSON object containing a list of matched trial records (up to 20), each with trial ID, title, phases, conditions, interventions, overall status, start and completion dates, enrollment count and type, primary and secondary endpoints, and a source URL to the ClinicalTrials.gov record. Also includes aggregate metadata: total trials in dataset, number matched, number returned, applied filters, dataset version, and a timestamp. A caveat note reminds that results are public registry data only and not medical advice.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "default": 10,
   "maximum": 20,
   "minimum": 1
  },
  "phase": {
   "type": "string",
   "maxLength": 100,
   "minLength": 1
  },
  "query": {
   "type": "string",
   "maxLength": 200,
   "minLength": 1
  },
  "condition": {
   "type": "string",
   "maxLength": 200,
   "minLength": 1
  },
  "intervention": {
   "type": "string",
   "maxLength": 200,
   "minLength": 1
  },
  "overallStatus": {
   "type": "string",
   "maxLength": 100,
   "minLength": 1
  },
  "resultsFirstPostTo": {
   "type": "string",
   "format": "date"
  },
  "resultsFirstPostFrom": {
   "type": "string",
   "format": "date"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "caveat": "Public registry information only; not medical advice, evidence grading, or a treatment recommendation. Verify the current primary record.",
  "trials": [
   {
    "title": "Intraoperative Investigation of a Directional Lead and Local Field Potentials",
    "phases": [],
    "trialId": "NCT03630302",
    "sourceUrl": "https://clinicaltrials.gov/study/NCT03630302",
    "startDate": "2018-07-12",
    "conditions": [
     "Parkinson"
    ],
    "resultStatus": "POSTED",
    "interventions": [
     "DBS"
    ],
    "overallStatus": "COMPLETED",
    "completionDate": "2020-01-31",
    "enrollmentType": "ACTUAL",
    "enrollmentCount": 10,
    "primaryEndpoints": [
     "Clinical programming prediction"
    ],
    "lastUpdatePostDate": "2021-05-28",
    "secondaryEndpoints": [
     "Side effect threshold"
    ],
    "resultsFirstPostDate": "2021-05-28"
   }
  ],
  "filters": {
   "limit": 5,
   "query": "Parkinson programming",
   "condition": "Parkinson",
   "overallStatus": "COMPLETED",
   "resultsFirstPostFrom": "2023-01-01"
  },
  "attribution": "Source: ClinicalTrials.gov, a resource of the U.S. National Library of Medicine.",
  "generatedAt": "2026-07-24T05:00:00.000Z",
  "totalTrials": 38638,
  "matchedTrials": 42,
  "datasetVersion": "2026-07-23",
  "returnedTrials": 1,
  "sourceDataTimestamp": "2026-07-23T09:00:05"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/decision-data-studio-clinical-trials-query-01d0690a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.ikoles.dev](https://www.zero.xyz/host/api.ikoles.dev/llms.txt)