application/problem+json. The type URI identifies stable machine semantics;
clients should branch on type or HTTP status, never parse the human detail.
index-not-found
HTTP 404. The requested identifier is not a published Mecone symbol or canonical slug.resource-not-found
HTTP 404. The requested v1 path is not a public API resource.commodity-not-found
HTTP 404. The requested identifier is not a published Mecone benchmark symbol or slug (raised by the/benchmarks routes and their legacy /commodities
aliases).
method-not-allowed
HTTP 405. The resource exists but does not support the requested method. The response preserves the standardAllow header.
invalid-request
HTTP 422. A path, query, or body parameter failed validation. Raised by the public read routes and by the operator plane’s key-management requests alike.unsupported-history-resolution
HTTP 400. The requested benchmark historyrange/resolution combination is
not supported.
credential-invalid
HTTP 401. The presented API key is unknown, revoked, or expired. A presented key is strictly enforced and never falls back to anonymous access; requests that present no key are open anonymous reads and never see this problem.credential-scope
HTTP 403. The presented API key is valid but does not carry the scope this plane requires.benchmark-not-entitled
HTTP 403. The presented API key carries a per-index entitlement list and the requested benchmark or flagship index is not on it. Entitled slugs are fixed at issuance; contact Mecone to widen them.rate-limited
HTTP 429. The presented API key is over its per-minute request limit. The response carriesRetry-After, RateLimit-Limit, RateLimit-Remaining, and
RateLimit-Reset headers; retry after the indicated delay.
index-unavailable
HTTP 503. The requested index cannot currently be served safely. RespectRetry-After when present.
official-round-unavailable
HTTP 503. No canonical API-committed round exists for the requested index. The API does not substitute a live/indicative snapshot.distribution-unavailable
HTTP 503. A current source probability distribution is unavailable. This does not necessarily make an already committed scalar round unavailable.statistics-unavailable
HTTP 503. Trailing index statistics are not available. RespectRetry-After
when present.
daily-closes-unavailable
HTTP 503. Daily reference closes are not available. RespectRetry-After
when present.
commodity-unavailable
HTTP 503. No usable observation for the requested benchmark is available at this time. RespectRetry-After when present.
request-failed
The request failed with the accompanying HTTP status without exposing internal implementation details.response-invalid
HTTP 500. The service refused to serialize a response that did not satisfy its safety or finite-number requirements.internal-error
HTTP 500. An unexpected server failure occurred. Supply the response’sX-Request-ID when contacting support.
Factor Lab
The following problems appear only on/api/v1/factors/**. Every Factor Lab request needs an
API key with the factors:read scope.
credential-required
HTTP 401. No credential was sent. Send an API key with thefactors:read scope.
unknown-equity
HTTP 404. Yahoo does not know the ticker as an equity.invalid-ticker
HTTP 422. The ticker is not 1 to 32 letters or digits with. or - between them.
not-an-equity
HTTP 422. The ticker is a fund, index, currency, or other non-equity.equity-source-unavailable
HTTP 503. Yahoo price data for the ticker could not be read.equity-history-unavailable
HTTP 503. Yahoo price history for the ticker could not be read.yfinance-unavailable
HTTP 503. The Yahoo price client is not available in this deployment.factors-unconfigured
HTTP 503. The server has no Factor Lab service credential configured, so Factor Lab fails closed.Operator plane
The following problems appear only on the credential-administration plane under/api/admin/**, which is operated by the Mecone team. Public read
integrations never see them. Malformed operator requests reuse the shared
invalid-request problem (HTTP 422).
admin-unconfigured
HTTP 503. The admin allowlist or identity configuration is missing, so the operator plane fails closed.admin-unavailable
HTTP 503. The identity provider could not be reached to verify the operator’s session. RespectRetry-After.
admin-unauthorized
HTTP 401. No valid operator session token was presented. API keys are consumer credentials, never operator identity, so anmck_ key is rejected here.
admin-forbidden
HTTP 403. The verified identity is not on the operator allowlist.store-unavailable
HTTP 503. The credential store could not be reached. RespectRetry-After.