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.
pip install -U omtxfrom 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
/v2/discovery/challengesList challenges
Return the public Discovery Challenges with their protein, eligible dataset and release, submission price and status.
curl https://api.omtx.ai/v2/discovery/challenges \
-H "x-api-key: YOUR_API_KEY"{
"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
}/v2/discovery/challenges/detailChallenge detail
Return one challenge by its `id`.
curl -G https://api.omtx.ai/v2/discovery/challenges/detail \
-H "x-api-key: YOUR_API_KEY" \
--data-urlencode "challenge_id=CHALLENGE_ID"{
"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"
}/v2/discovery/challenges/validateCheck SMILES
Check up to 1,000 SMILES against the challenge's eligible dataset without charging Wallet Credits.
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"]
}'{
"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
}/v2/discovery/challenges/submitSubmit 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 -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
}'{
"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-Keyheader is required. Retries follow the Idempotency page in these docs. accept_qualified_binder_data_licensemust betrue.- 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.