GateData.AI

Asset profile

Get the full profile for a single asset.

GET/api/v1/assets/{asset_id}
Domain
Asset & Entity
Level
Asset
MCP tool
assets_resolve (task=profile)

Available data

Returns
The full profile for a single asset
Market coverage
Crypto and US and Hong Kong equities
Query granularity
One asset per query

Authentication

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

Query Parameters

Asset positioning

Required.

asset_idstringpathExampleasset_btcrequired

Canonical asset id only (e.g. asset_btc); tickers return 404.

Response

dataobject
asset_idstringExampleasset_aapl_common_stock

Canonical asset identifier

display_namestringExampleApple Inc.

Asset display name and symbol

display_symbolstringExampleAAPL

Asset display name and symbol

entity_idstringExampleentity_sec_cik_0000320193

Canonical entity identifier

instrument_idstringExampleinstrument_aapl_common_stock

Canonical financial instrument identifier

primary_listing_idstringExamplelisting_aapl_xnas

Primary listing identifier

industrystringExampleTelecommunications Equipment

Industry and sector labels when classified

sectorstringExampleElectronic Technology

Industry and sector labels when classified

asset_typestringExampleequity

Classification and profile labels when present

countrystringExampleUnited States

Classification and profile labels when present

legal_namestringExampleApple Inc.

Classification and profile labels when present

websitestringExamplehttps://www.apple.com

Classification and profile labels when present

primary_venue_idstringExamplevenue_xnas

Primary venue id when mapped

gate_mappings_summary[]object[]

Gate symbol mapping summary

gate_symbolstringExampleAAPL

Gate tradable symbol

marketMarketExampleus_equity

Standard market

underlying_listing_idstringExamplelisting_aapl_xnas

Underlying listing id

gate_mapping_statusGateMappingStatusExamplemapped

Mapping status

data_statusDataStatusExampleok

ok / no_data / …

empty_reasonstring | null

Empty-result reason code

errorobject | null

Error object; null on success

lineage_refs[]object[]

Lineage refs (usually [] on the public body)

metadataobject

Response status and resolution information

actual_taskstringExampleprofile

listings / profile / resolve / search / …

route_reasonstringExamplerest_profile

Resolver route (e.g. gate_tradable_mapping, rest_profile, explicit_task)

domain_bindingsobject

Hints: market_data / onchain / events_news / fundamentals / news

newsobject

News binding: { asset_id } when mapped

asset_idstringExampleasset_aapl_common_stock

Asset id for news binding

events_newsobject

Events/news binding when mapped

entity_idstringExampleentity_sec_cik_0000320193

Entity id for events/news

fundamentalsobject

Fundamentals binding when mapped

entity_idstringExampleentity_sec_cik_0000320193

Entity id for fundamentals

market_dataobject

Market-data binding when mapped

listing_idstringExamplelisting_aapl_xnas

Listing id for market data

object_refs[]object[]

Unified object references

typeObjectRefTypeExamplelisting

Object reference type

idstringExamplelisting_aapl_xnas

Canonical object identifier

resolution_statusResolutionStatusExampleresolved

resolved / ambiguous / … (HTTP 200; not a transport failure)

source_refs[]object[]

Upstream source refs

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.