# OneShot Clinical Trials Finder

> OneShot Clinical Trials Finder is a paid API for AI agents from win.oneshotagent.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-19).

Search ClinicalTrials.gov for studies matching a treatment, condition, or keyword, filtered by status, returning structured study metadata.

## Facts

- Endpoint: POST https://win.oneshotagent.com/v1/tools/find/record-clinical-trials?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/oneshot-clinical-trials-finder-61e4b5f5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_kr_E0KBmdV3_C4XzGxEMJ

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 oneshot-clinical-trials-finder-61e4b5f5 -d '<json body>'
```

Example prompt: Find up to 5 recruiting clinical trials for secukinumab in psoriasis patients — I want to see the study titles, phases, sponsors, and countries.

## When to prefer this

Use this endpoint when an agent needs structured, queryable access to ClinicalTrials.gov data without managing API keys, particularly when the agent can pay per call in USDC on Base via x402. Prefer this over direct ClinicalTrials.gov API calls when operating in a pay-per-use agent architecture or when you need a clean, normalized JSON response with consistent fields.

## Known failure modes

- No studies found matching the query, condition, or status filters — returns empty studies array with total 0
- Invalid status enum value — request rejected with validation error
- Query too vague or misspelled — may return irrelevant or zero results
- Payment failure via x402 protocol — call not executed if USDC payment on Base is not processed
- Rate or quota limits on the underlying ClinicalTrials.gov data source — may return partial results

## How this service works

Find the registered clinical studies that match a condition, a treatment or other search words.

## Output

A JSON object containing a total count of matching studies and an array of study records, each including the NCT ID, ClinicalTrials.gov URL, title, phases, recruitment status, sponsor name, participating countries, medical conditions, enrollment number, study type, interventions, start date, and primary completion date.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "description": "The most studies to return. From 1 to 20. Defaults to `10`."
  },
  "query": {
   "type": "string",
   "description": "A treatment or other search words, for example secukinumab. 2 to 200 characters."
  },
  "status": {
   "enum": [
    "recruiting",
    "not_yet_recruiting",
    "active_not_recruiting",
    "completed",
    "terminated",
    "withdrawn",
    "suspended"
   ],
   "type": "string",
   "description": "Only studies with this status"
  },
  "condition": {
   "type": "string",
   "description": "A condition or disease, for example psoriasis. 2 to 120 characters."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "total": 1,
  "studies": [
   {
    "id": "NCT00000000",
    "url": "https://clinicaltrials.gov/study/NCT00000000",
    "title": "Example study of a treatment for psoriasis",
    "phases": [
     "PHASE3"
    ],
    "status": "recruiting",
    "sponsor": "Example Sponsor",
    "countries": [
     "United States",
     "Germany"
    ],
    "conditions": [
     "Psoriasis"
    ],
    "enrollment": 120,
    "start_date": "2025-03",
    "study_type": "interventional",
    "last_updated": "2026-09-04",
    "interventions": [
     "Secukinumab"
    ],
    "primary_completion_date": "2027-01"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/oneshot-clinical-trials-finder-61e4b5f5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from win.oneshotagent.com](https://www.zero.xyz/host/win.oneshotagent.com/llms.txt)
