Quickstart
Create an API key at /app/account, then run a strategy.
Agent reading this? Use /quickstart.md, /docs.md, /llms.txt.
1. Install
pip install iosisclient
export IOSIS_API_KEY=iosis_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx2. Strategy
Save as strategy.yaml:
format: iosis.strategy
version: 0.1.0
name: market-zscore
description: Rolling z-scores of changes in market probability.
nodes:
market:
op: source.dataset
version: 0.1.0
params:
name: polymarket_weather
changes:
op: transform.pct_change
version: 0.1.0
inputs:
price: market.yes_price
params:
input_column: price
output_column: changes
zscore:
op: transform.rolling_z_score
version: 0.1.0
inputs:
changes: changes.changes
params:
input_column: changes
output_column: zscore
periods: 20
min_samples: 10
outputs:
price: market.yes_price
zscore: zscore.zscore3. Submit
curl -X POST https://iosis.dev/api/runs \
-H "Authorization: Bearer $IOSIS_API_KEY" \
-H "Content-Type: application/yaml" \
-H "Idempotency-Key: $(uuidgen)" \
--data-binary @strategy.yamlfrom iosisclient import IosisClient
client = IosisClient()
run = client.submit_run("strategy.yaml")Submission returns 202:
{ "id": "8f3c…", "status": "queued" }4. Poll
curl https://iosis.dev/api/runs/8f3c… \
-H "Authorization: Bearer $IOSIS_API_KEY"result = client.wait_for_run(run["id"])While the run is not done, status is queued or running. When done it is succeeded or failed.
{ "run": { "id": "8f3c…", "status": "running" } }5. Results
{
"run": {
"id": "8f3c…",
"status": "succeeded",
"computeMs": 150,
"result": {
"kind": "result",
"name": "result.parquet",
"url": "https://…/result.parquet?X-Amz-…",
"sha256": "…",
"expiresAt": "2026-08-20T…Z"
},
"artifacts": [ … ]
}
}Result URLs expire after 60s. Download immediately.
6. Charts
curl https://iosis.dev/api/runs/8f3c…/charts \
-H "Authorization: Bearer $IOSIS_API_KEY"Chart URLs expire after 5min. Every output renders as SVG:
