Benchmark Cases Understanding the data available in each benchmark case.
Each benchmark case represents a real biotech catalyst event with rich contextual data for prediction.
GET /api/benchmark/cases?subset=oncology &limit = 100 &offset = 0 Parameter Default Description subsetoncologyFilter: oncology, non_oncology, or all limitall Max cases to return (up to 1000) offset0Pagination offset
Each case contains the following fields:
Field Type Description idstring Unique case identifier datestring Event date typestring Catalyst type (e.g., clinical_trial_result) indicationstring Therapeutic area indication_detailstring Specific disease/condition phasestring Clinical trial phase
Field Type Description press_releasestring De-identified press release text. Company names and ticker symbols are replaced with [COMPANY] and [TICKER]
Field Type Description clinical_trial.nct_idstring ClinicalTrials.gov ID clinical_trial.titlestring Trial title clinical_trial.phasestring Trial phase clinical_trial.statusstring Overall status clinical_trial.summarystring Brief summary clinical_trial.designobject Study design details clinical_trial.armsarray Treatment arms clinical_trial.interventionsarray Interventions/drugs clinical_trial.primary_endpointsarray Primary outcome measures clinical_trial.secondary_endpointsarray Secondary outcome measures clinical_trial.eligibilityobject Eligibility criteria clinical_trial.sponsorstring Trial sponsor clinical_trial.conditionsarray Conditions studied clinical_trial.has_resultsboolean Whether results are posted clinical_trial.resultsobject Posted results (if available)
Field Type Description company.sectorstring Company sector company.industrystring Industry classification company.employeesnumber Full-time employees company.exchangestring Stock exchange company.market_capnumber Market cap at time of event (USD) company.market_cap_tierstring Tier: micro, small, mid, large company.shares_outstandingnumber Total shares outstanding company.float_sharesnumber Public float
Field Type Description price_action.day_beforeobject OHLCV for the day before the catalyst price_action.catalyst_dayobject OHLCV for the catalyst day price_action.day_afterobject OHLCV for the day after price_action.volume_change_pctnumber Volume change percentage price_action.intraday_range_pctnumber Intraday price range percentage
240 of 317 catalysts (75.7%) have linked PubMed research papers. These provide published clinical evidence that can inform trading predictions.
Field Type Description pubmed_articlesarray Related PubMed papers pubmed_articles[].pmidstring PubMed ID pubmed_articles[].titlestring Article title pubmed_articles[].journalstring Journal name pubmed_articles[].datestring Publication date pubmed_articles[].authorsarray Author list (first 5) pubmed_articles[].urlstring PubMed URL pubmed_articles[].doistring|null Digital Object Identifier pubmed_articles[].pmc_idstring|null PubMed Central ID (indicates free full text) pubmed_articles[].abstractstring Article abstract
To get the full paper text for a catalyst's articles, use the /api/catalysts/:id/papers endpoint. Full text is fetched from PubMed Central (PMC) for open access articles. See API Reference for details.
Strategy prompts automatically include PubMed research content (full text when available, abstracts as fallback) via the {pubmed_research} template variable.
Field Type Description ground_truth.actual_impactstring The actual impact category ground_truth.percent_changenumber Actual stock price change (%) ground_truth.price_beforenumber Stock price before event ground_truth.price_afternumber Stock price after event
{ "total" : 369 , "count" : 1 , "subset" : "oncology" , "impact_categories" : [ "very_negative" , "negative" , "slightly_negative" , "neutral" , "slightly_positive" , "positive" , "very_positive" ], "cases" : [ { "id" : "onc_0001" , "date" : "2024-01-15" , "type" : "clinical_trial_result" , "indication" : "oncology" , "indication_detail" : "Non-Small Cell Lung Cancer" , "phase" : "Phase 3" , "press_release" : "[COMPANY] Announces Positive Phase 3 Results..." , "clinical_trial" : { "nct_id" : "NCT12345678" , "..." : "..." }, "company" : { "market_cap" : 5200000000 , "market_cap_tier" : "mid" , "..." : "..." }, "price_action" : { "..." : "..." }, "pubmed_articles" : [], "ground_truth" : { "actual_impact" : "positive" , "percent_change" : 12.5 , "price_before" : 45.20 , "price_after" : 50.85 } } ] } 