{"openapi":"3.1.0","info":{"title":"MALI Public API","version":"1.0","summary":"Forecast bands, volatility regimes and technical signals for US-listed tickers.","description":"Programmatic access to MALI's forecast bands, volatility regimes and technical signals.\n\nKeys come with the Pro, Edge and Institutional plans and are made on /developers while signed in.\n\nEach key may make 60 requests per 60 seconds; a /signals request counts one per symbol.\n\nA figure the analysis service could not produce is null, with the reason in the field beside it.\n\nInformational 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.","termsOfService":"https://mali-trw.com/legal/eula","contact":{"name":"MALI","url":"https://mali-trw.com/developers","email":"mali@trw-opex.com"}},"externalDocs":{"description":"Guide, examples and API keys","url":"https://mali-trw.com/developers"},"servers":[{"url":"https://mali-trw.com"}],"security":[{"bearerAuth":[]},{"apiKeyHeader":[]}],"tags":[{"name":"Data","description":"Forecasts, regimes and signals. Each needs a key."},{"name":"About","description":"The API's own description."}],"paths":{"/api/public/v1":{"get":{"operationId":"index","summary":"What the API offers","description":"The version, authentication, rate limit and endpoints. Needs no key.","tags":["About"],"security":[],"responses":{"200":{"description":"The API's description","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/public/v1/forecast":{"get":{"operationId":"forecast","summary":"Forecast bands","description":"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.","tags":["Data"],"responses":{"200":{"description":"Forecast bands","headers":{"X-RateLimit-Limit":{"description":"Requests this key may make per minute.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current minute.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"When the current window ends, in Unix seconds.","schema":{"type":"integer"}},"X-MALI-API-Version":{"description":"The API version that answered.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Forecast"},"example":{"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"]}}}},"400":{"description":"The request is malformed: a missing or invalid symbol, days or body.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"No key, a malformed key, or a key that doesn't exist or was revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The key's account has no plan that includes the API, or its subscription has lapsed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"The analysis service couldn't answer for that input, such as an unknown symbol.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"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.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-RateLimit-Limit":{"description":"Requests this key may make per minute.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current minute.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"When the current window ends, in Unix seconds.","schema":{"type":"integer"}},"X-MALI-API-Version":{"description":"The API version that answered.","schema":{"type":"string"}},"Retry-After":{"description":"Seconds until the next window.","schema":{"type":"integer"}}}},"503":{"description":"The analysis service or the key service is unavailable. The reason is in the body.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"symbol","in":"query","required":true,"description":"The ticker, e.g. SPY.","schema":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9.\\-^=]{0,14}$","example":"SPY"}},{"name":"days","in":"query","required":false,"description":"Trading sessions to project, a whole number from 1 to 90. Default 5.","schema":{"type":"integer","minimum":1,"maximum":90,"default":5}}]},"post":{"operationId":"forecastPost","summary":"Forecast bands","description":"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.","tags":["Data"],"responses":{"200":{"description":"Forecast bands","headers":{"X-RateLimit-Limit":{"description":"Requests this key may make per minute.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current minute.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"When the current window ends, in Unix seconds.","schema":{"type":"integer"}},"X-MALI-API-Version":{"description":"The API version that answered.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Forecast"},"example":{"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"]}}}},"400":{"description":"The request is malformed: a missing or invalid symbol, days or body.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"No key, a malformed key, or a key that doesn't exist or was revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The key's account has no plan that includes the API, or its subscription has lapsed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"The analysis service couldn't answer for that input, such as an unknown symbol.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"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.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-RateLimit-Limit":{"description":"Requests this key may make per minute.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current minute.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"When the current window ends, in Unix seconds.","schema":{"type":"integer"}},"X-MALI-API-Version":{"description":"The API version that answered.","schema":{"type":"string"}},"Retry-After":{"description":"Seconds until the next window.","schema":{"type":"integer"}}}},"503":{"description":"The analysis service or the key service is unavailable. The reason is in the body.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["symbol"],"properties":{"symbol":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9.\\-^=]{0,14}$","example":"SPY","description":"The ticker, e.g. SPY."},"days":{"type":"integer","minimum":1,"maximum":90,"default":5,"description":"Trading sessions to project, a whole number from 1 to 90. Default 5."}}},"example":{"symbol":"SPY","days":2}}}}}},"/api/public/v1/regime":{"get":{"operationId":"regime","summary":"Volatility regime","description":"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.","tags":["Data"],"responses":{"200":{"description":"Volatility regime","headers":{"X-RateLimit-Limit":{"description":"Requests this key may make per minute.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current minute.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"When the current window ends, in Unix seconds.","schema":{"type":"integer"}},"X-MALI-API-Version":{"description":"The API version that answered.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Regime"},"example":{"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"]}}}},"400":{"description":"The request is malformed: a missing or invalid symbol, days or body.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"No key, a malformed key, or a key that doesn't exist or was revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The key's account has no plan that includes the API, or its subscription has lapsed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"The analysis service couldn't answer for that input, such as an unknown symbol.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"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.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-RateLimit-Limit":{"description":"Requests this key may make per minute.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current minute.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"When the current window ends, in Unix seconds.","schema":{"type":"integer"}},"X-MALI-API-Version":{"description":"The API version that answered.","schema":{"type":"string"}},"Retry-After":{"description":"Seconds until the next window.","schema":{"type":"integer"}}}},"503":{"description":"The analysis service or the key service is unavailable. The reason is in the body.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"symbol","in":"query","required":true,"description":"The ticker, e.g. AAPL.","schema":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9.\\-^=]{0,14}$","example":"SPY"}}]},"post":{"operationId":"regimePost","summary":"Volatility regime","description":"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.","tags":["Data"],"responses":{"200":{"description":"Volatility regime","headers":{"X-RateLimit-Limit":{"description":"Requests this key may make per minute.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current minute.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"When the current window ends, in Unix seconds.","schema":{"type":"integer"}},"X-MALI-API-Version":{"description":"The API version that answered.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Regime"},"example":{"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"]}}}},"400":{"description":"The request is malformed: a missing or invalid symbol, days or body.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"No key, a malformed key, or a key that doesn't exist or was revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The key's account has no plan that includes the API, or its subscription has lapsed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"The analysis service couldn't answer for that input, such as an unknown symbol.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"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.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-RateLimit-Limit":{"description":"Requests this key may make per minute.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current minute.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"When the current window ends, in Unix seconds.","schema":{"type":"integer"}},"X-MALI-API-Version":{"description":"The API version that answered.","schema":{"type":"string"}},"Retry-After":{"description":"Seconds until the next window.","schema":{"type":"integer"}}}},"503":{"description":"The analysis service or the key service is unavailable. The reason is in the body.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["symbol"],"properties":{"symbol":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9.\\-^=]{0,14}$","example":"SPY","description":"The ticker, e.g. AAPL."}}},"example":{"symbol":"AAPL"}}}}}},"/api/public/v1/signals":{"get":{"operationId":"signals","summary":"Technical signals","description":"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.","tags":["Data"],"responses":{"200":{"description":"Technical signals","headers":{"X-RateLimit-Limit":{"description":"Requests this key may make per minute.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current minute.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"When the current window ends, in Unix seconds.","schema":{"type":"integer"}},"X-MALI-API-Version":{"description":"The API version that answered.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Signals"},"example":{"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"]}}}},"400":{"description":"The request is malformed: a missing or invalid symbol, days or body.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"No key, a malformed key, or a key that doesn't exist or was revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The key's account has no plan that includes the API, or its subscription has lapsed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"The analysis service couldn't answer for that input, such as an unknown symbol.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"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.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-RateLimit-Limit":{"description":"Requests this key may make per minute.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current minute.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"When the current window ends, in Unix seconds.","schema":{"type":"integer"}},"X-MALI-API-Version":{"description":"The API version that answered.","schema":{"type":"string"}},"Retry-After":{"description":"Seconds until the next window.","schema":{"type":"integer"}}}},"503":{"description":"The analysis service or the key service is unavailable. The reason is in the body.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"symbols","in":"query","required":true,"description":"Tickers, comma-separated, at most 10. Each one counts as a request against your limit.","schema":{"type":"string","description":"At most 10 tickers","example":"SPY,AAPL"}}]}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Authorization: Bearer mali_pk_..."},"apiKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"Band":{"type":["array","null"],"items":{"type":"number"},"minItems":2,"maxItems":2,"description":"[low, high]"},"ForecastSession":{"type":"object","properties":{"session":{"type":["integer","null"]},"price":{"type":["number","null"]},"ci_50":{"$ref":"#/components/schemas/Band"},"ci_80":{"$ref":"#/components/schemas/Band"},"ci_95":{"$ref":"#/components/schemas/Band"}}},"Forecast":{"type":"object","properties":{"symbol":{"type":["string","null"]},"as_of":{"type":["string","null"],"format":"date-time"},"model":{"type":["string","null"]},"method":{"type":["string","null"]},"current_price":{"type":["number","null"]},"direction":{"type":["string","null"],"enum":["bullish","bearish","neutral",null]},"mu_daily":{"type":["number","null"]},"sigma_daily":{"type":["number","null"]},"sessions_used":{"type":["integer","null"]},"horizon":{"type":"array","items":{"$ref":"#/components/schemas/ForecastSession"}},"confidence":{"type":"null"},"confidence_unavailable":{"type":"string"},"disclaimer":{"type":"string","const":"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":{"type":"array","items":{"type":"string"},"description":"The pages that govern use of the figures."}}},"Regime":{"type":"object","properties":{"symbol":{"type":["string","null"]},"as_of":{"type":["string","null"],"format":"date-time"},"regime_label":{"type":["string","null"],"enum":["high volatility","normal volatility","low volatility",null]},"regime_unavailable":{"type":["string","null"]},"annualised_volatility":{"type":["number","null"]},"vol_zscore":{"type":["number","null"]},"momentum_20d":{"type":["number","null"]},"method":{"type":["string","null"]},"disclaimer":{"type":"string","const":"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":{"type":"array","items":{"type":"string"},"description":"The pages that govern use of the figures."}}},"Signal":{"type":"object","properties":{"symbol":{"type":"string"},"signal":{"type":["string","null"],"enum":["BUY","SELL","HOLD",null]},"conviction":{"type":["string","null"],"enum":["STRONG","MODERATE","WEAK",null]},"signal_unavailable":{"type":["string","null"]},"source":{"type":"string","const":"technical_analysis"},"as_of":{"type":["string","null"]}}},"Signals":{"type":"object","properties":{"as_of":{"type":"string","format":"date-time"},"signals":{"type":"array","items":{"$ref":"#/components/schemas/Signal"}},"disclaimer":{"type":"string","const":"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":{"type":"array","items":{"type":"string"},"description":"The pages that govern use of the figures."}}},"Error":{"type":"object","required":["error","reason"],"properties":{"error":{"type":"string"},"reason":{"type":"string"},"docs":{"type":"string","description":"Where the API is documented."}}}}}}