Skip to main content
Newest releases first.
v0.4.0

REST API v2

  • Segment endpoints for finding comparable companies: GET /segments/companies/{companyId}, GET /segments/companies/{companyId}/similar, GET /segments/groups/{groupId}, and GET /segments/taxonomy/{taxonomy}. See Find comparable companies.
  • You read a company’s segment data with a subscription to that company. POST /segments/subscriptions subscribes you to companies for 365 days, and GET /segments/subscriptions lists 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.
v0.3.0

REST API v2

A strategy’s status is the state of the active version’s latest run, live or historical, and completed is true once the active version has a completed run. To wait for a run you just submitted, poll GET /strategies/{strategyId}/versions/{versionId} with its asOfDate.
  • GET /usage and GET /usage/runs are in v2.
  • New GET /strategies/{strategyId}/runs: the as-of dates of a version, newest first, each with its run state, has_result, and factsheet_status.
  • Versions carry factsheet_status, and a factsheet can be unavailable.
  • 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 asOfDate returns 404 while 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 /portfolios returns 409 for a name you already use. To change a portfolio, call PUT /portfolios/{portfolioId}.
  • POST /helper/companies/lookup returns each company’s marketCap.
  • overlap in POST /strategies/exposures is an integer: the number of the portfolio’s companies in the strategy.

MCP server

  • get_usage uses v2 GET /usage.
  • get_strategy_version returns factsheet_status.
  • request_strategy_factsheet works for historical runs. Only the strategy’s owner can call it.
v0.2.0

MCP server at a new URL, with a new tool set

The MCP server is now at https://mcp.noonum.ai/mcp. The old URL, https://api.noonum.ai/v1/mcp, no longer works and does not redirect. Point your client at the new URL, and sign in again if you use OAuth.
  • 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: Bearer token.
  • 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, and get_usage. Each tool calls REST API v2 with your credentials, except get_usage, which calls v1 GET /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 call revive_strategy to bring it back. For one company’s reasoning and evidence, call get_strategy_company.
  • list_strategies returns one page at a time, set by limit and offset, and total counts the strategies across all pages. Set scope to user (the default) for your own strategies, public for the public catalog, or all for both. Each strategy carries its ID, name, objective, run state, and summary performance metrics.
  • get_strategy_companies returns JSON rows, highest convictionScore first, instead of a markdown table. It takes exchangeRegion, domicile, marketCapMin, marketCapMax, limit, and offset in place of filters, sort_by, sort_order, page, and page_size. strategy_id and include_reasoning are now strategyId and includeReasoning. total counts the matching companies across all pages.
  • get_strategy leaves out the weekly performance series.
  • submit_strategy takes strategyId in place of strategy_id. It returns right away with the version and its run state, instead of waiting for the run and returning its companies. Poll get_strategy_version until completed is true. A status of -2 means the run failed, and -1 means a temporary error that is retried automatically. Each new run uses one credit from your plan, and a failed run is not charged.
  • submit_strategy requests a factsheet only when you set create_factsheet to true. To start one later, call request_strategy_factsheet.
  • get_strategy_factsheet returns a status of ready, generating, or not_requested. A ready factsheet comes with a url that expires after about 5 minutes.

REST API

Evidence pubDate is now an ISO 8601 string in UTC, such as "2026-07-08T20:18:06+00:00", instead of an integer Unix timestamp. Update any code that reads it as a number.
  • The pubDate change covers GET /strategies/{strategyId}/companies/{companyId} and GET /strategies/{strategyId}/evidences in v1 and v2. It also covers GET /premade-strategies/{strategyId}/companies/{companyId} and GET /premade-strategies/{strategyId}/evidences in 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 v1 POST /strategies/{strategyId}/submit, v1 POST /strategies/{strategyId}/historical-data, and v2 POST /strategies/{strategyId}/submit. GET /usage and GET /usage/runs now return the same message with their 409.
  • v2: on the /strategies/{strategyId} routes, a malformed strategy ID, version ID, or date returns 400 with a message that names the bad value.
  • v2: when you read a public strategy you don’t own, user_id is null.
  • v2: when your plan’s credits run out, the 429 message of a submit now says that no credits are left in the current period. The 423 message 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. force regenerates a factsheet, or retries one that stays generating. It takes effect only for the strategy’s owner, and the REST API ignores it from anyone else.
  • marketCapMin and marketCapMax do not apply to historical runs, which carry no market cap. The REST API reference now says so.
v0.1.0

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.