{"name":"parkinsons-pathways-agent-api","version":"1","description":"Agent-facing read API for curated Parkinson's disease clinical trials (AI plain-language summaries, structured eligibility, sites), with x402 USDC payments on Base.","docs":{"openapi":"/api/agent/v1/openapi.json","humanLanding":"/agents","markdownTrial":"/agent/trials/{nctId}.md"},"auth":{"modes":[{"kind":"free_tier_api_key","header":"X-API-Key","request":"POST /api/agent/v1/keys/request"},{"kind":"x402_payment","protocol":"x402","header":"X-PAYMENT"}]},"pricing":{"network":"base","payTo":"0x3ecFe6030AeD6d101e0C72Af2f2c0e7CfF781d69","asset":"USDC","routes":[{"method":"GET","path":"/api/agent/v1/trials/search","price":"$0.005","description":"Search the curated Parkinson's trial set (keyword, condition, sponsor, status, phase, country, geo radius)."},{"method":"GET","path":"/api/agent/v1/trials/{nctId}/brief","price":"$0.02","description":"Single Parkinson's trial brief. Basic tier is free; ?include=full adds the AI plain-language summary, eligibility criteria, structured eligibility ontology, sites, and contacts."},{"method":"GET","path":"/api/agent/v1/trials/{nctId}/snapshot","price":"$0.01","description":"Current machine-readable record of a curated Parkinson's trial."},{"method":"POST","path":"/api/agent/v1/match","price":"$0.10","description":"Rank Parkinson's trials for a structured patient profile."},{"method":"GET","path":"/api/agent/v1/pd/eligibility-search","price":"$0.01","description":"Structured Parkinson's eligibility search over the curated PD set. Patient-centric filters on the parsed eligibility ontology: hy_min/hy_max (Hoehn and Yahr window), levodopa/dyskinesia/dbs/gba/lrrk2 (required|excluded|allowed|not_required), stable_dose, fluctuations (required|not_required), disease_duration_years, onset_age_years, moca, mmse, updrs (each is the patient's value; only trials whose stated window admits it match), healthy_volunteers, status, phase, country, q, limit, cursor. Unstated fields pass (conservative nulls); every non-null parsed field carries an evidence snippet and confidence."},{"method":"GET","path":"/api/agent/v1/credits/tiers","price":"$0","description":"List available prepaid topup tiers + bonus structure."},{"method":"GET","path":"/api/agent/v1/credits/balance","price":"$0","description":"Read prepaid credit balance (requires X-API-Key)."},{"method":"POST","path":"/api/agent/v1/credits/topup","price":"tier-priced","description":"Top up prepaid credits. Pass ?tier=trial|builder|growth|scale|enterprise. Per-tier x402 settlement: $10 → $10.00, $50 → $55.00 (10% bonus), $200 → $250.00 (25% bonus, most popular), $1000 → $1300.00 (30% bonus), $5000 → $6650.00 (33% bonus). Subsequent paid calls debit the balance before falling back to per-call x402."},{"method":"GET","path":"/api/agent/v1/credits/transactions","price":"$0","description":"List recent topup/debit/bonus/refund ledger entries (requires X-API-Key)."},{"method":"GET","path":"/api/agent/v1/llms-index","price":"$0","description":"Free machine-readable index of endpoints + pricing."}]},"credits":{"description":"Prepaid credits. Top up once over x402, then every paid call automatically debits the balance before falling back to per-call x402.","topupUrl":"/api/agent/v1/credits/topup","balanceUrl":"/api/agent/v1/credits/balance","transactionsUrl":"/api/agent/v1/credits/transactions","tiers":[{"tier":"trial","paidUsd":10,"bonusPct":0,"creditedUsd":10,"popular":false},{"tier":"builder","paidUsd":50,"bonusPct":10,"creditedUsd":55,"popular":false},{"tier":"growth","paidUsd":200,"bonusPct":25,"creditedUsd":250,"popular":true},{"tier":"scale","paidUsd":1000,"bonusPct":30,"creditedUsd":1300,"popular":false},{"tier":"enterprise","paidUsd":5000,"bonusPct":33,"creditedUsd":6650,"popular":false}]}}