REST API v2
- Segment endpoints for finding comparable companies:
GET /segments/companies/{companyId},GET /segments/companies/{companyId}/similar,GET /segments/groups/{groupId}, andGET /segments/taxonomy/{taxonomy}. See Find comparable companies. - You read a company’s segment data with a subscription to that company.
POST /segments/subscriptionssubscribes you to companies for 365 days, andGET /segments/subscriptionslists your subscriptions and your plan’s limit. - A segment group’s segments and companies, and the segment names in the taxonomy tree, need taxonomy access in your plan.
REST API v2
GET /usageandGET /usage/runsare in v2.- New
GET /strategies/{strategyId}/runs: the as-of dates of a version, newest first, each with its run state,has_result, andfactsheet_status. - Versions carry
factsheet_status, and a factsheet can beunavailable. - Historical runs can have factsheets and market caps, and the market cap filters apply to them. Only the strategy’s owner can request a factsheet, and a request that does not finish can be made again.
- A read with an
asOfDatereturns404while that date has no completed run. - A live run that has not finished 30 minutes after it was submitted reads as
-2. Submit its date again to run it again. POST /portfoliosreturns409for a name you already use. To change a portfolio, callPUT /portfolios/{portfolioId}.POST /helper/companies/lookupreturns each company’smarketCap.overlapinPOST /strategies/exposuresis an integer: the number of the portfolio’s companies in the strategy.
MCP server
get_usageuses v2GET /usage.get_strategy_versionreturnsfactsheet_status.request_strategy_factsheetworks for historical runs. Only the strategy’s owner can call it.
MCP server at a new URL, with a new tool set
- The new URL has no REST API version in its path, so it stays the same when the REST API adds a version.
- OAuth clients now get a refresh token, so you don’t have to sign in again each time an access token expires. You can still send a Noonum API key as the
Authorization: Bearertoken. - The MCP server has 17 tools:
search_companies,list_strategies,get_strategy,create_strategy,update_strategy,archive_strategy,list_archived_strategies,revive_strategy,submit_strategy,list_strategy_versions,get_strategy_version,get_strategy_available_dates,get_strategy_companies,get_strategy_company,get_strategy_factsheet,request_strategy_factsheet, andget_usage. Each tool calls REST API v2 with your credentials, exceptget_usage, which calls v1GET /usage. See MCP server. - The prompts are gone. So are the tools that deleted a strategy, listed premade strategies, returned evidence for every company at once, and downloaded companies as CSV. To remove a strategy, call
archive_strategy, and callrevive_strategyto bring it back. For one company’s reasoning and evidence, callget_strategy_company. list_strategiesreturns one page at a time, set bylimitandoffset, andtotalcounts the strategies across all pages. Setscopetouser(the default) for your own strategies,publicfor the public catalog, orallfor both. Each strategy carries its ID, name, objective, run state, and summary performance metrics.get_strategy_companiesreturns JSON rows, highestconvictionScorefirst, instead of a markdown table. It takesexchangeRegion,domicile,marketCapMin,marketCapMax,limit, andoffsetin place offilters,sort_by,sort_order,page, andpage_size.strategy_idandinclude_reasoningare nowstrategyIdandincludeReasoning.totalcounts the matching companies across all pages.get_strategyleaves out the weekly performance series.submit_strategytakesstrategyIdin place ofstrategy_id. It returns right away with the version and its run state, instead of waiting for the run and returning its companies. Pollget_strategy_versionuntilcompletedistrue. Astatusof-2means the run failed, and-1means a temporary error that is retried automatically. Each new run uses one credit from your plan, and a failed run is not charged.submit_strategyrequests a factsheet only when you setcreate_factsheettotrue. To start one later, callrequest_strategy_factsheet.get_strategy_factsheetreturns astatusofready,generating, ornot_requested. Areadyfactsheet comes with aurlthat expires after about 5 minutes.
REST API
- The
pubDatechange coversGET /strategies/{strategyId}/companies/{companyId}andGET /strategies/{strategyId}/evidencesin v1 and v2. It also coversGET /premade-strategies/{strategyId}/companies/{companyId}andGET /premade-strategies/{strategyId}/evidencesin v1. - If you sign in with an email that already belongs to another Noonum account, a submit returns
409. The message tells you to sign in the way you first signed up, or to contact support. This applies to v1POST /strategies/{strategyId}/submit, v1POST /strategies/{strategyId}/historical-data, and v2POST /strategies/{strategyId}/submit.GET /usageandGET /usage/runsnow return the same message with their409. - v2: on the
/strategies/{strategyId}routes, a malformed strategy ID, version ID, or date returns400with a message that names the bad value. - v2: when you read a public strategy you don’t own,
user_idisnull. - v2: when your plan’s credits run out, the
429message of a submit now says that no credits are left in the current period. The423message now says that a run for the same version and date is already in progress. - v2: a factsheet request while one is generating starts nothing new.
forceregenerates a factsheet, or retries one that staysgenerating. It takes effect only for the strategy’s owner, and the REST API ignores it from anyone else. marketCapMinandmarketCapMaxdo not apply to historical runs, which carry no market cap. The REST API reference now says so.
Initial public documentation site
First version of the public documentation site, covering:- Get started: quickstart and authentication guides.
- Guides: walkthroughs for building, iterating on, and analyzing strategies.
- REST API Reference: documentation for all endpoints, with “Try It” support.
- MCP: setup guides for the Noonum MCP server.
- Methodology: deep dives into signals, scores, and portfolio optimization.