Check a trade against the rating and its record
check_tradeChecks one U.S.-listed stock or ETF at the moment of a trade: returns the full Market Eyes Live MELANY rating (the same fields as get_stock_rating) together with what the public graded record says about calls carrying that tier: the share of such calls that beat more than half of the other core stocks rated the same day, over the following week and month, with the number of calls behind each figure and the 50% no skill line (a REIT is looked up under the app's own REIT label; an ETF gets no tier figure, because funds are not graded against the same day list, and the record says so). Use this when an agent is about to propose a buy or a sell, for example 'check NVDA before I buy' or 'what does Market Eyes Live say about selling AAPL', so the person approving the trade sees the rating, its tone and its record side by side. The side (buy or sell) only shapes the wording; the rating and the record are the same either way. Do not use for quotes, order placement, options, crypto, futures, non-U.S. listings, or a personal recommendation. Limitations: the daily-refreshed set answers instantly, other covered tickers are scored live at a lower hourly limit; the record is read from the public feed at https://marketeyeslive.com/api/validation-status and is left out, with a note, when that feed cannot be read in time; it does not return any trade plan values. Method: https://marketeyeslive.com/how-melany-is-tested.html. Research data, not financial advice; this tool is read-only and never places trades.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"symbol": "<symbol>"
},
"name": "check_trade"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| side | No | optional: the trade being considered; it changes the wording only | |
| symbol | Yes | U.S. ticker symbol, e.g. NVDA, AAPL, VOO |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| read | Yes | the rating in one sentence and its tone | |
| side | No | buy or sell, when given | |
| as_of | Yes | YYYY-MM-DD scoring date | |
| links | No | ||
| scale | No | ||
| theme | No | ||
| record | Yes | What the public graded record says about calls carrying this tier: the share that beat more than half of the other core stocks rated the same day, over each window. 50% is the no skill line. Present on every success; available is false when the feed could not be read in time. | |
| source | Yes | data source name | |
| symbol | Yes | ||
| company | No | ||
| factors | Yes | each 0-100, higher is stronger | |
| freshness | No | present only when scored live on demand | |
| top_risks | No | descriptive risk notes; never instructions | |
| disclaimer | Yes | ||
| trade_plan | No | Present only when Market Eyes Live has a trade plan for this ticker (including a suggested entry zone and a model position size; the same plan for every reader, not based on anyone's account, holdings or finances). The plan values are never included here; they are part of a Market Eyes Live subscription. | |
| asset_class | No | stock, etf or reit: which label table the eight factor slots carry (a fund's quality slot is cost and structure, a REIT's valuation slot is price against funds from operations) | |
| rating_tier | No | Conviction tier. Mature ladder, weakest to strongest: Unfavorable, Hold, Favorable, Highest Conviction. Favorable and Highest Conviction are both favorable reads; Highest Conviction is a composite of 69 or above (for a stock, a small hysteresis can hold a borderline label steady between refreshes; a fund or REIT word follows its label in the app, which has none). Names the mature ladder does not cover carry their own label: Promising, then Very Promising, then Rising Star for names without mature fundamentals, Runner! for a momentum surge, Catalyst Watch for a news-driven gap up on volume. ETFs and REITs use the same mature ladder, chosen by the tone of the fund's own label in the app (a favorable fund label reads Favorable or Highest Conviction, a cautious or neutral one Hold, a negative one Unfavorable); a leveraged or inverse fund never reads above Hold. These nine words are the complete set; null when no tier applies. | |
| composite_score | Yes | 0-100, higher is stronger |