---
title: smi_ergodic (SMI Ergodic)
description: "smi_ergodic API reference: parameters, response fields and example requests."
---

# `smi_ergodic` — SMI Ergodic

> Category: **Momentum** · Composite

::: tip Reading the response
Use `POST /api/indicators?explain=true` to include interpretation notes at `indicators[responseKey].explain`. Read numeric results from `columns` and `data` in the same object.
:::

This is a momentum indicator.

## Parameters

| Parameter | Type | Default |
|------|------|--------|
| `long_len` | int | `20` |
| `short_len` | int | `5` |
| `sig_len` | int | `5` |

## Output columns

| Column |
|------|
| `erg` |
| `erg_signal` |



## Native features

Set top-level `signals: true` and read `indicators[responseKey].signals`. By default features are evaluated on closed bars: `true` is a positive result, `false` a valid negative result, and `null` unknown. These are not trade instructions.

This indicator supports `include_forming: true`: treat the current final OHLCV sample as complete under the same native rules, returning one set of values, features and objects. The signal table appends `bar_status`: `closed` for closed bars, `forming` for a trial with `confirmed_at_ms=null`. A trial may disappear on later updates or at close. For BYO, still set `last_bar_closed: false`. Close requirements below describe the default mode; trials only admit the final sample without shortening structural windows or model confirmation requirements. See [forming trials](/signals#forming).

History lengths are minimum evaluation requirements, not convergence guarantees. Comparisons use unrounded values and the exact boundaries below. Do not turn `null` into `false` on gaps, invalid dependencies or forming bars in the default mode.

| Feature column | Kind | Rule | Meaning | History / validity |
| --- | --- | --- | --- | --- |
| `smi_ergodic.cross_up` | `event` | Previous erg <= erg_signal; current erg > erg_signal. | Normalized smoothed momentum crosses its own signal line. | long_len + short_len + sig_len contiguous bars and valid dependencies on both bars. |
| `smi_ergodic.cross_down` | `event` | Previous erg >= erg_signal; current erg < erg_signal. | Normalized smoothed momentum crosses its own signal line. | long_len + short_len + sig_len contiguous bars and valid dependencies on both bars. |

See [feature requests](/compute#native-features) for the format and examples. `/api/chart` also accepts `signals: true`, marking confirmed events by default. With `include_forming`, trial events also produce markers tagged `bar_status=forming`; states are not drawn on every bar. See [feature charts](/compute#feature-chart).

## Example call

```bash
curl -X POST -H "Authorization: Bearer mq_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "exchange": "binance",
    "market":   "perp",
    "symbol":   "BTCUSDT",
    "interval": "5m",
    "limit":    100,
    "signals":  true,
    "calc":     [{"name": "smi_ergodic", "params": {"long_len": 20, "short_len": 5, "sig_len": 5}}]
  }' \
  https://api.mobiusquant.ai/api/indicators
```

## Full interpretation guide

Field meanings, interpretation rules and usage notes are
documented in Chinese at:

[smi_ergodic (中文详情)](https://docs.mobiusquant.ai/zh/indicators/smi_ergodic)

## Related indicators

[accelerator_oscillator](./accelerator_oscillator) · [awesome_oscillator](./awesome_oscillator) · [cci](./cci) · [chande_mo](./chande_mo) · [connors_rsi](./connors_rsi) · [coppock_curve](./coppock_curve) · [dpo](./dpo) · [kst](./kst)