GateData.AI

行情快照

查询指定资产或挂牌的最新价格、涨跌、成交量与盘口摘要。

GET/api/v1/markets/snapshot
数据域
行情与流动性
解析层级
资产或挂牌
MCP 工具
market_data_query (task=snapshot)

可查询数据

返回数据
指定资产或挂牌的最新价格、涨跌、成交量与盘口摘要
市场覆盖
Crypto、美股、港股
查询粒度
每次查询一个资产；使用挂牌标识时缩小到单一交易场所的挂牌

认证

所有请求需携带 Authorization: Bearer YOUR_API_KEY 或 X-API-KEY。

请求参数

资产定位

至少填写一项：listing_id / asset_id / query / ticker / symbol / base。

listing_idstringquery示例listing_okx_BTC_USDT_spot

交易场所挂牌标识，标识某个交易品种在特定交易场所的挂牌记录

asset_idstringquery示例asset_btc

资产标识，标识股票、加密资产等资产对象

querystringquery示例BTC

用于解析查询对象的检索词

兼容定位字段
tickerstringquery示例BTC

query 的 ticker 别名。

symbolstringquery示例BTC

query 的 symbol 别名。

basestringquery示例BTC

交易对基础资产代码

市场筛选

均为可选；股票查询必须填写 market。

marketMarketquery示例crypto

查询对象所属市场

venuestringquery示例okx可选

查询指定的交易场所代码

market_typeMarketTypequery示例spot可选

交易产品类型

quotestringquery示例USDT可选

交易对计价资产代码

响应

同一接口下，加密资产与股票返回的字段不完全相同

通用字段
pricenumber | null示例64079.8

最新一笔有效成交的价格

volumenumber | null

统计窗口内累计成交数量，单位为股或币

turnovernumber | null

统计窗口内累计成交金额，约等于成交数量 × 成交价。

avg_pricenumber | null

成交均价 = turnover ÷ volume

bid_pricenumber | null

买一价

ask_pricenumber | null

卖一价

best_bidnumber | null

买一价，与 bid_price 同义。

best_asknumber | null

卖一价，与 ask_price 同义。

mid_pricenumber | null

双边均有时的中间价：(bid + ask) / 2。

spread_bpsnumber | null

相对 mid_price 的买卖价差（基点 bps）。

listing_idstring | null示例listing_gate_BTC_USDT_spot

交易场所挂牌标识，标识某个交易品种在特定交易场所的挂牌记录

venue_idstring | null示例venue_gate

交易场所标识，标识交易所或交易平台

tickerstring

展示用的代码，例如 AAPL、BTC。

marketMarket

该接口支持的市场码（crypto | us_equity | hk_equity）。

snapshot_typeSnapshotType

本次快照的聚合范围

updated_atiso8601 | null示例2026-08-17T17:07:11.560722597Z

本次报价或响应的最近更新时间（UTC ISO-8601）。

as_of_utciso8601 | null

报价在数据源发生的时间（UTC ISO-8601）

source_delay_secondsnumber | null

数据延迟秒数（当前时间 − as_of_utc/updated_at）

snapshot_timeiso8601 | null

盘口快照时间

data_statusDataStatus示例ready

业务数据可用状态

metadataobject
data_statusDataStatus示例ready

业务数据可用状态

partialboolean

为 true 表示响应本就不完整，与 data_status=partial 对应。

limitationsstring[] | null

本次响应的已知数据限制，例如 order_book_size_unavailable、volume_ratio_unavailable_live、quote_source_latency_high、snapshot_stale。

missing_fieldsstring[]

已知缺失的字段名，例如 price_change_24h、volume_24h、bid_size。

updated_atiso8601 | null示例2026-08-17T17:07:11Z

本次响应的组装时间（UTC ISO-8601）

object_refs[]object[]

统一对象引用数组

typeObjectRefType示例asset

对象引用类型

idstring示例asset_btc

对象标识，标识 type 指定的具体对象

entity_idstring

主体标识，标识公司、项目方或协议等主体

asset_idstring示例asset_btc

资产标识，标识股票、加密资产等资产对象

listing_idstring

交易场所挂牌标识，标识某个交易品种在特定交易场所的挂牌记录

instrument_idstring

交易工具标识，标识股票、现货交易对或合约等具体交易产品

venue_idstring

交易场所标识，标识交易所或交易平台

event_refstring

关联事件标识，标识与当前对象关联的事件

market_idstring

预测市场标识，标识预测事件下的具体市场

venuestring

对象关联的平台代码

resolved_fromstring示例asset_entity

对象解析所用输入来源

resolution_confidencestring示例resolved

对象解析置信度

limitations includes listing_id_unavailable_source_code_onlystring (limitation token)

未能识别挂牌，此时 object_refs 可能为空，但仍会返回价格。

actual_taskstring

实际执行的任务类型

route_reasonstring

任务或对象路由原因

empty_reasonstring

无数据时的原因码，例如 object_not_found、snapshot_expired。

reasonstring

无数据的可读说明。

next_actionstring

无数据时的下一步建议。

try_paramsobject

本次请求实际使用的查询参数回显，例如 query、market。

加密资产
price_change_24hnumber | null示例813.8134600000001

过去 24 小时绝对价格变化

price_change_24h_absolutenumber | null示例813.8134600000001

过去 24 小时绝对价格变化

price_change_24h_percentnumber | null示例1.27

过去 24 小时价格涨跌幅

volume_24hnumber | null示例263668502.3634611

过去 24 小时累计成交数量

volume_24h_unitstring | null示例quote

volume_24h 的计量单位，例如以计价币计的金额

venue_quotes[]object[]

按交易场所拆分的报价行

listing_idstring

交易场所挂牌标识，标识某个交易品种在特定交易场所的挂牌记录

venue_idstring

交易场所标识，标识交易所或交易平台

pricenumber

该交易场所的最新成交价

volumenumber | null

该交易场所的成交数量

volume_24hnumber | null

该交易场所过去 24 小时的成交数量（有则返回）

updated_atiso8601

该交易场所的报价时间（UTC ISO-8601）

股票
last_pricenumber | null

当日最新成交价，与 price 同义。

amplitudenumber | null

当日价格振幅百分比 =（当日最高价 − 当日最低价）/ 上一交易日收盘价 × 100

open_pricenumber | null

当日第一笔有效成交价。

high_pricenumber | null

当日最高成交价。

low_pricenumber | null

当日最低成交价。

prev_close_pricenumber | null

上一交易日收盘价，用作涨跌计算的基准价。

volume_rationumber | null

当前成交量相对历史均值的倍数（量比）

session_change_pctnumber | null

当日相对上一交易日收盘价的涨跌幅

session_change_amountnumber | null

当日相对上一交易日收盘价的绝对涨跌额。

bid_volumenumber | null

买一挂单数量

ask_volumenumber | null

卖一挂单数量

market_sessionMarketSession

当前所处的交易时段。

field_sourcesobject

各字段的数据来源标识，取值如 live:session、live:orderbook、live:day。

错误与降级

200
assets_resolve 名称多命中；从 data[] 候选确认。
200
对象已解析但无可用数据；empty_reason 可为 not_covered_by_source / unsupported_metric / limited_depth。
400
参数无效，或行情 listing 多命中；歧义响应含 required_params + candidates。
401
缺少 API Key，或 Key 无效。
403
当前 Key 的 scope 或套餐无权访问该数据域。
404
请求的资源不存在；数据源不覆盖不归入 404。
402
Credits 或月度额度耗尽。
429
请求频率超限；body 返回 retry_after，响应头同步返回 Retry-After。