AnalyzeStock

curl --request GET \
  --url https://api.worldmonitor.app/api/market/v1/analyze-stock \
  --header 'X-WorldMonitor-Key: <api-key>'

const options = {method: 'GET', headers: {'X-WorldMonitor-Key': '<api-key>'}};

fetch('https://api.worldmonitor.app/api/market/v1/analyze-stock', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.worldmonitor.app/api/market/v1/analyze-stock",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-WorldMonitor-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.worldmonitor.app/api/market/v1/analyze-stock"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-WorldMonitor-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.worldmonitor.app/api/market/v1/analyze-stock")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-WorldMonitor-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "action": "example",
  "analysisAt": 1717200000000,
  "analysisId": "example-id",
  "analystConsensus": {
    "buy": 1,
    "hold": 1,
    "period": "daily",
    "sell": 1,
    "strongBuy": 1
  },
  "atr": 1.5
}

{
  "violations": [
    {
      "field": "<string>",
      "description": "<string>"
    }
  ]
}

{
  "error": "<string>"
}

{
  "error": "<string>",
  "requiredTier": 123,
  "currentTier": 123,
  "planKey": "<string>"
}

{
  "message": "<string>"
}

{
  "message": "<string>"
}

GET

api

market

analyze-stock

AnalyzeStock

curl --request GET \
  --url https://api.worldmonitor.app/api/market/v1/analyze-stock \
  --header 'X-WorldMonitor-Key: <api-key>'

const options = {method: 'GET', headers: {'X-WorldMonitor-Key': '<api-key>'}};

fetch('https://api.worldmonitor.app/api/market/v1/analyze-stock', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.worldmonitor.app/api/market/v1/analyze-stock",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-WorldMonitor-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.worldmonitor.app/api/market/v1/analyze-stock"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-WorldMonitor-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.worldmonitor.app/api/market/v1/analyze-stock")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-WorldMonitor-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "action": "example",
  "analysisAt": 1717200000000,
  "analysisId": "example-id",
  "analystConsensus": {
    "buy": 1,
    "hold": 1,
    "period": "daily",
    "sell": 1,
    "strongBuy": 1
  },
  "atr": 1.5
}

{
  "violations": [
    {
      "field": "<string>",
      "description": "<string>"
    }
  ]
}

{
  "error": "<string>"
}

{
  "error": "<string>",
  "requiredTier": 123,
  "currentTier": 123,
  "planKey": "<string>"
}

{
  "message": "<string>"
}

{
  "message": "<string>"
}

Authorizations

X-WorldMonitor-Key

string

header

required

User-issued WorldMonitor API key.

Query Parameters

symbol

string

required

Stock ticker symbol to analyze.

name

string

Optional company display name used to disambiguate the symbol.

include_news

boolean

Whether to include recent news in the stock analysis.

jmespath

string

Optional JMESPath expression applied server-side to project or reduce the JSON response before it is returned (mirrors the MCP jmespath argument). Invalid expressions, expressions larger than 1024 UTF-8 bytes, or projections that exceed the 256 KB output cap return HTTP 400 with a {_jmespath_error, original_keys} envelope. Grammar and worked examples: https://www.worldmonitor.app/docs/mcp-jmespath.

Response

Successful response

available

boolean

symbol

string

name

string

display

string

currency

string

currentPrice

number<double>

changePercent

number<double>

signalScore

number<double>

Technical-analysis score (0-100), retained as a stable pair with signal for clients that predate the fundamentals-blended rating.

signal

string

Technical-only signal paired with signal_score. New clients should use rating_signal with composite_score for the surfaced investment rating.

trendStatus

string

volumeStatus

string

macdStatus

string

rsiStatus

string

summary

string

action

string

confidence

string

technicalSummary

string

newsSummary

string

whyNow

string

bullishFactors

string[]

riskFactors

string[]

supportLevels

number<double>[]

resistanceLevels

number<double>[]

headlines

object[]

Show child attributes

ma5

number<double>

ma10

number<double>

ma20

number<double>

ma60

number<double>

biasMa5

number<double>

biasMa10

number<double>

biasMa20

number<double>

volumeRatio5d

number<double>

rsi12

number<double>

macdDif

number<double>

macdDea

number<double>

macdBar

number<double>

provider

string

model

string

fallback

boolean

newsSearched

boolean

generatedAt

string

analysisId

string

analysisAt

integer<int64>

Warning: Values > 2^53 may lose precision in JavaScript

stopLoss

number<double>

takeProfit

number<double>

engineVersion

string

analystConsensus

object

Show child attributes

priceTarget

object

Show child attributes

recentUpgrades

object[]

Show child attributes

dividendYield

number<double>

trailingAnnualDividendRate

number<double>

exDividendDate

integer<int64>

Warning: Values > 2^53 may lose precision in JavaScript

payoutRatio

number<double>

dividendFrequency

string

dividendCagr

number<double>

marketSession

string

US-equity trading session at analysis time: "regular", "pre", "post" or "closed". Empty when session detection does not apply (non-US symbols).

extendedPrice

number<double>

Latest pre/post-market price from Yahoo extended-hours candles. Only set when market_session is "pre" or "post" and extended data is available.

extendedChangePercent

number<double>

Extended-hours change % vs the last regular-session close. Only set when extended_price is set.

fundamentals

object

Show child attributes

fundamentalScore

number<double>

Fundamental health score (0-100) blended from the quality/growth/leverage fundamentals above. Unset when too few fundamentals are available to score, in which case composite_score falls back to signal_score.

compositeScore

number<double>

Blend of signal_score (technicals) and fundamental_score that drives rating_signal, so a Strong buy/sell no longer fires on price action alone. Equals signal_score when fundamental_score is unset.

nextEarningsDate

string

Next scheduled earnings date (YYYY-MM-DD) plus consensus EPS / revenue for the symbol, joined from the market:earnings-calendar:v1 seed. Unset when the symbol has no upcoming (not-yet-reported) entry in the seed's ~2-week window. (61-62 are taken by a concurrent PR; using 63-65 to avoid a field collision.)

consensusEps

number<double>

consensusRevenue

number<double>

newsSentiment

number<double>

LLM-derived news sentiment for the analyzed symbol: a signed score in [-1, 1] (-1 very bearish, 0 neutral / no material news, +1 very bullish), emitted by the same overlay model that already reads the headlines — no extra call. Omitted when the analysis falls back to rules (no LLM overlay). (69 avoids a field collision with in-flight PRs: 61-62 blend fundamentals into the rating, 63-65 are the merged earnings join, 66-68 are the in-flight risk-analytics PR.)

realizedVolatility

number<double>

Risk analytics computed from the 6-month daily candles already fetched for the technical snapshot (no extra upstream call). (66-68 avoid a field collision: 61-62 are claimed by the in-flight PR that blends fundamentals into the rating, and 63-65 by the merged earnings join.)

Annualized realized volatility — sample stdev of daily log returns × √252 — as a fractional ratio where 0.25 means 25%. 0 when history is insufficient.

atr

number<double>

Wilder's 14-period Average True Range, in the response currency's price units. 0 when history is insufficient.

maxDrawdown

number<double>

Maximum peak-to-trough drawdown over the window, as a non-positive fractional ratio where -0.25 means a 25% decline. 0 for a monotonically rising series.

ratingSignal

string

Fundamentals-blended signal paired with composite_score. Kept separate from the legacy technical-only signal/signal_score pair so already-loaded web, desktop, and API clients never render a mixed-version rating.

ratingSummary

string

Fundamentals-blended narrative paired with rating_signal/composite_score. Legacy summary remains paired with signal/signal_score during rollout.

ratingAction

string

Fundamentals-blended action paired with rating_signal/composite_score. Legacy action remains paired with signal/signal_score during rollout.

ratingConfidence

string

Fundamentals-blended confidence paired with rating_signal/composite_score. Legacy confidence remains paired with signal/signal_score during rollout.

ratingWhyNow

string

Fundamentals-blended explanation paired with rating_signal/composite_score. Legacy why_now remains paired with signal/signal_score during rollout.

ratingBullishFactors

string[]

Fundamentals-aware positive factors supporting the composite rating. Legacy bullish_factors remain technical-only during rollout.

ratingRiskFactors

string[]

Fundamentals-aware risks supporting the composite rating. Legacy risk_factors remain technical-only during rollout.

Overview

Geopolitical

Natural Events

Economy & Markets

Infrastructure & Transport

Health & Environment

Other

AnalyzeStock

Authorizations

Query Parameters

Response