GateData.AI

Financial metrics

Query key financial metrics for a company.

GET/api/v1/fundamentals/metrics
Domain
Fundamentals
Level
Public-company entity
MCP tool
fundamentals_query (task=metrics)

Available data

Returns
Key financial metrics for a company
Market coverage
US and Hong Kong equities
Query granularity
One company per query; some metrics are by fiscal period, while valuation ratios are usually the latest value

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[]

Metric rows: metric_name, metric_value, period_key, unit

metric_namestringExamplepb

Metric name

metric_valuenumber | nullExample41.527

Metric value

period_keystringExampledefault

Period key

unitstring | null

Unit

entity_idstringExampleentity_sec_cik_0000320193

Company entity id

as_of_utcdatetime | nullExample2026-08-14T00:00:00.000+0000

Metric as-of (UTC)

data_statusDataStatusExampleok

Per-row readiness

empty_reasonstring | null

Per-row empty reason

data_statusDataStatusExampleok

ok / partial / no_data / not_ready / stale

empty_reasonstring | null

Empty / partial reason code when applicable

errorobject | null

Error object (code / message); null on success

metadataobject
actual_taskstringExamplemetrics

Routed task: profile / statements / metrics / …

data_statusDataStatusExampleok

ok / partial / no_data / not_ready / stale

limitations[]string[]Exampleserving_mvp

Coverage / MVP limitation tags

route_reasonstringExampleexplicit_task

Route reason (e.g. explicit_task)

updated_atdatetime | stringExample2026-08-17T08:25:06Z

Envelope update time (UTC)

object_refs[]object[]

Unified object references

typeObjectRefTypeExampleentity

Object reference type

idstringExampleentity_sec_cik_0000320193

Canonical object identifier

entity_idstringExampleentity_sec_cik_0000320193

Canonical entity identifier

asset_idstringExampleasset_aapl_common_stock

Canonical asset identifier

listing_idstringExamplelisting_aapl_xnas

Canonical listing identifier

instrument_idstringExampleinstrument_aapl_common_stock

Canonical financial instrument identifier

venue_idstringExamplevenue_xnas

Canonical trading venue identifier

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.