Discovery Challenges

List Open Pipeline Discovery Challenges, check SMILES eligibility without charge, and submit molecules with Wallet Credits from the Python SDK, the Om API, or Om MCP.

Each Discovery Challenge names one protein. Choose molecules from the challenge's eligible Om Accessible Space dataset (eligible_dataset and eligible_release in the challenge record), check them, then submit. Om tests every accepted molecule by AS-MS. Each accepted molecule costs the challenge's submission_price_credits in Wallet Credits. Challenge terms and results are on each challenge page at omtx.ai/discovery/challenges.

Python SDK

Use omtx 2.0.25 or later. Earlier versions send a license field the submit endpoint no longer accepts.

Install or updateBash
pip install -U omtx
Check and submit moleculesPython
from omtx import OmClient

client = OmClient()  # reads OMTX_API_KEY

challenges = client.discovery_challenges.list()["challenges"]
challenge = next(c for c in challenges if c["slug"] == "open-pipeline-stat6")

smiles = ["<candidate SMILES from the eligible dataset>"]

# Free: reports which SMILES are eligible and what they would cost.
eligibility = client.discovery_challenges.validate(
    challenge_id=challenge["id"],
    smiles=smiles,
    idempotency_key="stat6-validate-1",
)

# Spends Wallet Credits for each accepted molecule.
submission = client.discovery_challenges.submit(
    challenge_id=challenge["id"],
    smiles=smiles,
    accept_qualified_binder_data_license=True,
    idempotency_key="stat6-submit-1",
)

Om API

GET/v2/discovery/challenges

List challenges

Return the public Discovery Challenges with their protein, eligible dataset and release, submission price and status.

cURL
curl https://api.omtx.ai/v2/discovery/challenges \
  -H "x-api-key: YOUR_API_KEY"
Response
{
  "challenges": [
    {
      "id": "<challenge id>",
      "slug": "open-pipeline-stat6",
      "protein_name": "STAT6",
      "eligible_dataset": "om_50",
      "eligible_release": "enumerated_v2_1_price_verified",
      "submission_price_credits": 5000,
      "status": "open"
    }
  ],
  "programs": [],
  "count": 1
}
GET/v2/discovery/challenges/detail

Challenge detail

Return one challenge by its `id`.

cURL
curl -G https://api.omtx.ai/v2/discovery/challenges/detail \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "challenge_id=CHALLENGE_ID"
Response
{
  "id": "<challenge id>",
  "slug": "open-pipeline-stat6",
  "protein_name": "STAT6",
  "eligible_dataset": "om_50",
  "eligible_release": "enumerated_v2_1_price_verified",
  "submission_price_credits": 5000,
  "status": "open"
}
POST/v2/discovery/challenges/validate

Check SMILES

Check up to 1,000 SMILES against the challenge's eligible dataset without charging Wallet Credits.

cURL
curl -X POST https://api.omtx.ai/v2/discovery/challenges/validate \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "challenge_id": "CHALLENGE_ID",
    "smiles": ["SMILES_1", "SMILES_2"]
  }'
Response
{
  "challenge_id": "<challenge id>",
  "items": [
    {
      "input_index": 0,
      "input_smiles": "SMILES_1",
      "canonical_smiles": "<canonical SMILES>",
      "canonical_smiles_hash": "<sha256>",
      "status": "available",
      "message": null
    },
    {
      "input_index": 1,
      "input_smiles": "SMILES_2",
      "canonical_smiles": null,
      "canonical_smiles_hash": null,
      "status": "unavailable",
      "message": "Molecule is not present in the configured Om Accessible Space catalog."
    }
  ],
  "available_count": 1,
  "unavailable_count": 1,
  "total_credits": 5000,
  "final_catalog_validation_required": true
}
POST/v2/discovery/challenges/submit

Submit molecules

Submit up to 1,000 SMILES under your Om account. Each accepted molecule is charged the challenge's submission price in Wallet Credits.

cURL
curl -X POST https://api.omtx.ai/v2/discovery/challenges/submit \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Idempotency-Key: stat6-submit-1" \
  -H "Content-Type: application/json" \
  -d '{
    "challenge_id": "CHALLENGE_ID",
    "smiles": ["SMILES_1", "SMILES_2"],
    "accept_qualified_binder_data_license": true
  }'
Response
{
  "batch_id": "<batch id>",
  "challenge_id": "<challenge id>",
  "item_count": 2,
  "wallet_credits_charged": 10000,
  "balance_after": 90000,
  "already_processed": false,
  "submissions": [
    {
      "submission_id": "<submission id>",
      "canonical_smiles_hash": "<sha256>",
      "status": "<submission status>",
      "credits_charged": 5000,
      "acceptance_order": 1
    }
  ]
}
  • The Idempotency-Key header is required. Retries follow the Idempotency page in these docs.
  • accept_qualified_binder_data_license must be true.
  • Responses are shortened to the main fields.

Om MCP

The hosted Om MCP exposes the same flow as discovery_challenges_list, discovery_challenge_get, discovery_challenge_validate and discovery_challenge_submit, plus discovery_challenge_submissions_list and discovery_challenge_result_get for your submissions and results. To connect, follow the MCP quickstart in these docs.