MALI
MALI Platform
AI Stock Research

Developers · API v1.0

The MALI public API

Forecast bands, volatility regimes and technical signals for any US-listed ticker, as JSON over HTTPS. A figure MALI could not produce comes back as null, with the reason beside it, never as a made-up number.

Quick start

  1. Make a key below while signed in. Keys come with the Pro, Edge and Institutional plans; an account may hold 5 at a time. A key is shown once, when it is made.
  2. Send it as Authorization: Bearer mali_pk_… or X-API-Key: mali_pk_…, and keep it out of code you share: read it from an environment variable such as MALI_API_KEY.
  3. Call an endpoint. The base URL is https://mali-trw.com.
curl
curl "https://mali-trw.com/api/public/v1/signals?symbols=SPY,AAPL" \
  -H "Authorization: Bearer $MALI_API_KEY"
Python
import os, requests

r = requests.get(
    "https://mali-trw.com/api/public/v1/forecast",
    params={"symbol": "SPY", "days": 5},
    headers={"Authorization": f"Bearer {os.environ['MALI_API_KEY']}"},
    timeout=60,
)
r.raise_for_status()
for step in r.json()["horizon"]:
    print(step["session"], step["price"], step["ci_80"])
JavaScript
const res = await fetch("https://mali-trw.com/api/public/v1/regime?symbol=AAPL", {
  headers: { Authorization: `Bearer ${process.env.MALI_API_KEY}` },
});
if (!res.ok) throw new Error((await res.json()).reason);
const { regime_label, vol_zscore } = await res.json();
console.log(regime_label, vol_zscore);

Limits and terms

Rate limit

60 requests a minute per key; a /signals request counts one per symbol it names. Every answer carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset (Unix seconds). Past the limit the answer is 429 with Retry-After.

Real data only

Figures come from MALI's analysis service for the key's account. When it can't produce one, the field is null and a field beside it says why, such as signal_unavailable or regime_unavailable.

Terms

Informational only. Nothing here is financial, investment, trading, tax or legal advice, and it can be wrong, incomplete or delayed. Use of the MALI API is governed by the MALI EULA, Disclaimer and Risk Disclosure. Every data answer carries this notice as disclaimer and terms.

EULADisclaimerRisk Disclosure

Endpoints

The public API is the three endpoints below, plus GET /api/public/v1, which describes them and needs no key. The figures in the example answers are for illustration.

GETPOST/api/public/v1/forecast

Forecast bands

A lognormal drift projection: the drift and volatility come from the symbol's last 60 daily log returns, and each trading session carries exact 50%, 80% and 95% bands. It extrapolates recent returns; it is not a trained model, so confidence is null, with the reason.

symbol
The ticker, e.g. SPY.
days?
Trading sessions to project, a whole number from 1 to 90. Default 5.

Request

curl -X POST "https://mali-trw.com/api/public/v1/forecast" \
  -H "Authorization: Bearer $MALI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"symbol": "SPY", "days": 2}'

# or: GET /api/public/v1/forecast?symbol=SPY&days=2

Example answer

{
  "symbol": "SPY",
  "as_of": "2026-10-20T14:05:12.481Z",
  "model": "lognormal_drift",
  "method": "μ/σ of the last 60 daily log returns; bands are exact lognormal quantiles per trading session",
  "current_price": 571.2,
  "direction": "bullish",
  "mu_daily": 0.000412,
  "sigma_daily": 0.009871,
  "sessions_used": 60,
  "horizon": [
    {
      "session": 1,
      "price": 571.4354,
      "ci_50": [567.63, 575.26],
      "ci_80": [564.24, 578.71],
      "ci_95": [560.43, 582.64]
    },
    {
      "session": 2,
      "price": 571.6709,
      "ci_50": [566.31, 577.07],
      "ci_80": [561.53, 581.98],
      "ci_95": [556.18, 587.6]
    }
  ],
  "confidence": null,
  "confidence_unavailable": "This forecast extrapolates the last 60 daily returns; it is not a trained model, so no confidence is reported.",
  "disclaimer": "Informational only. Nothing here is financial, investment, trading, tax or legal advice, and it can be wrong, incomplete or delayed. Use of the MALI API is governed by the MALI EULA, Disclaimer and Risk Disclosure.",
  "terms": [
    "/legal/eula",
    "/legal/disclaimer",
    "/legal/risk-disclosure"
  ]
}
GETPOST/api/public/v1/regime

Volatility regime

The symbol's volatility regime: its 20-session realised volatility against its own distribution over the past year. A z-score above 1 is high volatility, below -1 low. With too little history the label is null, with the reason.

symbol
The ticker, e.g. AAPL.

Request

curl "https://mali-trw.com/api/public/v1/regime?symbol=AAPL" \
  -H "Authorization: Bearer $MALI_API_KEY"

Example answer

{
  "symbol": "AAPL",
  "as_of": "2026-10-20T14:05:12.481Z",
  "regime_label": "normal volatility",
  "regime_unavailable": null,
  "annualised_volatility": 0.2184,
  "vol_zscore": 0.412,
  "momentum_20d": 0.0315,
  "method": "20-session realised vol z-score vs the past year",
  "disclaimer": "Informational only. Nothing here is financial, investment, trading, tax or legal advice, and it can be wrong, incomplete or delayed. Use of the MALI API is governed by the MALI EULA, Disclaimer and Risk Disclosure.",
  "terms": [
    "/legal/eula",
    "/legal/disclaimer",
    "/legal/risk-disclosure"
  ]
}
GET/api/public/v1/signals

Technical signals

Technical signals for up to 10 tickers: BUY, SELL or HOLD from price against its 20- and 50-day averages and the 14-day RSI, with a conviction of STRONG, MODERATE or WEAK. A symbol without enough history has a null signal and the reason.

symbols
Tickers, comma-separated, at most 10. Each one counts as a request against your limit.

Request

curl "https://mali-trw.com/api/public/v1/signals?symbols=SPY,AAPL,NEWIPO" \
  -H "Authorization: Bearer $MALI_API_KEY"

Example answer

{
  "as_of": "2026-10-20T14:05:12.481Z",
  "signals": [
    {
      "symbol": "SPY",
      "signal": "BUY",
      "conviction": "STRONG",
      "signal_unavailable": null,
      "source": "technical_analysis",
      "as_of": "2026-10-17"
    },
    {
      "symbol": "AAPL",
      "signal": "HOLD",
      "conviction": "WEAK",
      "signal_unavailable": null,
      "source": "technical_analysis",
      "as_of": "2026-10-17"
    },
    {
      "symbol": "NEWIPO",
      "signal": null,
      "conviction": null,
      "signal_unavailable": "Under 50 days of closes: the 20/50-day averages and RSI the signal needs are not available.",
      "source": "technical_analysis",
      "as_of": "2026-10-17"
    }
  ],
  "disclaimer": "Informational only. Nothing here is financial, investment, trading, tax or legal advice, and it can be wrong, incomplete or delayed. Use of the MALI API is governed by the MALI EULA, Disclaimer and Risk Disclosure.",
  "terms": [
    "/legal/eula",
    "/legal/disclaimer",
    "/legal/risk-disclosure"
  ]
}

Errors

Errors are JSON with error, reason and docs.

400
The request is malformed: a missing or invalid symbol, days or body.
401
No key, a malformed key, or a key that doesn't exist or was revoked.
403
The key's account has no plan that includes the API, or its subscription has lapsed.
422
The analysis service couldn't answer for that input, such as an unknown symbol.
429
More than 60 requests from this key in the current minute (a /signals request counts one per symbol). Retry-After says when to try again.
503
The analysis service or the key service is unavailable. The reason is in the body.

Connect an AI assistant (MCP)

MALI runs an MCP server at https://mali-trw.com/mcp. Connect it and your assistant can call get_forecast, get_volatility_regime and get_technical_signals itself, with your account: the same answers, plan and limit as the REST API.

Connectors in Claude.ai and ChatGPT sign in: add a custom connector with that URL, sign in to MALI and choose Allow. MALI makes an API key for the app, listed with your keys below, where you can revoke it. Other clients can send a key you make yourself as a header.

Claude.ai or ChatGPT · Add a custom connector
URL:  https://mali-trw.com/mcp

Then sign in to MALI and choose Allow.
No key to copy: MALI makes one for the app.
Claude Code · Run in a terminal
claude mcp add --transport http mali https://mali-trw.com/mcp \
  --header "Authorization: Bearer $MALI_API_KEY"
Cursor · ~/.cursor/mcp.json
{
  "mcpServers": {
    "mali": {
      "url": "https://mali-trw.com/mcp",
      "headers": { "Authorization": "Bearer mali_pk_..." }
    }
  }
}
VS Code · .vscode/mcp.json
{
  "servers": {
    "mali": {
      "type": "http",
      "url": "https://mali-trw.com/mcp",
      "headers": { "Authorization": "Bearer mali_pk_..." }
    }
  }
}
Claude Desktop · claude_desktop_config.json, through mcp-remote
{
  "mcpServers": {
    "mali": {
      "command": "npx",
      "args": ["mcp-remote", "https://mali-trw.com/mcp",
               "--header", "Authorization:${MALI_AUTH}"],
      "env": { "MALI_AUTH": "Bearer mali_pk_..." }
    }
  }
}

Your API keys

Loading…

Tools that read the spec

Import /developers/openapi.json into Postman, Insomnia or an OpenAPI code generator to get a typed client, or give it to an AI assistant that can call HTTP APIs.