GateData.AI

Valuation metricsComing soon

Query valuation metrics for a company.

This data domain is coming soon. Documentation is available now for reading and integration planning. REST and MCP try-it are disabled until this domain launches — paths and parameters will not change at GA.
GET/api/v1/fundamentals/valuation-metrics
Domain
Fundamentals
Level
Public-company entity
MCP tool
fundamentals_query (task=metrics)

Available data

Returns
Valuation metrics for a company
Market coverage
US and Hong Kong equities
Query granularity
One company per query

Authentication

Send Authorization: Bearer YOUR_API_KEY or X-API-KEY on every request.

Query Parameters

Company positioning

Provide query, symbol, or ticker when possible; an empty request returns no_data.

querystringqueryExampleAAPLoptional

Search text used to identify the object you want.

symbolstringqueryExampleAAPLoptional

Company symbol; compatibility alias of query.

tickerstringqueryExampleAAPLoptional

Company ticker.

Query options

All optional.

marketMarketqueryExampleus_equityoptional

us_equity | hk_equity | kr_equity | uk_equity | jp_equity | crypto

limitintegerqueryExample20optional

Max rows to return (up to 1000).

Response

dataobject
metrics[]object[]

Valuation metric rows; often [] when out of MVP scope

data_statusDataStatusExampleno_data

ok / partial / no_data / not_ready / stale

empty_reasonstring | nullExamplevaluation_current_out_of_scope

Empty / partial reason code when applicable

errorobject | null

Error object (code / message); null on success

metadataobject
actual_taskstringExamplemetrics

Routed task: profile / statements / metrics / …

data_statusDataStatusExampleno_data

ok / partial / no_data / not_ready / stale

limitations[]string[]Exampleraw_dwd_plus_builder_mvp

Coverage / MVP limitation tags

updated_atdatetime | stringExample2026-07-28T08:00:00Z

Envelope update time (UTC)

object_refs[]object[]

Unified object references

external_refs[]object[]

External refs (e.g. SEC EDGAR filings)

lineage_refs[]object[]

Lineage refs (usually [] on the public body)

source_refs[]object[]

Upstream source refs (usually [] on the public body)

Errors & fallback

200
assets_resolve name multi-match; confirm from data[] candidates.
200
The object resolved but no data is available; empty_reason may be not_covered_by_source, unsupported_metric, or limited_depth.
400
Invalid parameters or an ambiguous market listing; ambiguity responses include required_params + candidates.
401
The API key is missing or invalid.
403
The current key scope or plan cannot access this data domain.
404
The requested resource does not exist; source coverage gaps are not 404 responses.
402
Credits or monthly quota exhausted.
429
Request rate exceeded; retry_after is returned in the body and Retry-After in the response headers.