Asset listings & Gate mapping

View listing information and Gate mappings.

GET/api/v1/assets/{asset_id}/listings

Domain

Asset & Entity

Level

Listings

MCP tool

assets_resolve (task=listings)

Available data

Returns: Listing information and Gate mappings
Market coverage: Crypto and US and Hong Kong equities
Query granularity: One asset per query; only listings of that asset are returned

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; the only required business parameter.

Listing filters

All optional.

venue_idstringqueryExamplevenue_gateoptional

Filter by canonical venue id (e.g. venue_gate).

market_typeMarketTypequeryExamplespotoptional

Type of traded product.

quote_currencystringqueryExampleUSDToptional

Filter by quote currency; quote is not a filter.

limitintegerqueryExample20optional

Result cap 1–50; default 20 (prefer ≤20 in the UI).

Response

dataobject

asset_idstringExampleasset_aapl_common_stock

Canonical asset identifier

underlying_listings[]object[]

Venue listing rows (listing_id, ticker, venue_id, …)

listing_idstringExamplelisting_aapl_xnas

Underlying listing id

instrument_idstringExampleinstrument_aapl_common_stock

Instrument id

venue_idstringExamplevenue_xnas

Venue id

tickerstringExampleAAPL

Venue ticker

quote_currencystringExampleUSD

Quote currency

listing_statusstringExampleunknown

Listing status

gate_listings[]object[]

Gate tradable symbols mapped to the asset

gate_symbolstringExampleAAPL

Gate tradable symbol

gate_quote_currencystringExampleUSDT

Gate quote / settle currency

gate_listing_idstring | null

Gate listing id when mapped

gate_trading_statusstring | null

Gate trading status when known

gate_mappings[]object[]

Gate ↔ underlying mapping status

underlying_listing_idstringExamplelisting_aapl_xnas

Underlying listing id

gate_mapping_statusGateMappingStatusExamplemapped

Mapping status (e.g. mapped)

gate_listing_idstring | null

Gate listing id when mapped

mapping_confidencenumber | null

Mapping confidence when scored

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_taskstringExamplelistings

listings / profile / resolve / search / …

object_refs_validation_statusstringExamplenot_provided

not_provided when the client did not send object_refs

route_reasonstringExampleexplicit_task

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.