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_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

2. 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.zscore

3. 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.yaml
from 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:

Placeholder chart output