按场景选择接入路径

交易终端、分析看板、策略回测和 AI Agent 用的是同一套 API Key、同一种 JSON 结构。区别只在于：实时推送走 WebSocket，查询和回补走 REST。

四种典型场景

每个方案页都写明了需要哪些端点、怎么组合，以及从哪个套餐起步。

用 WebSocket 推送驱动交易终端、行情看板、OMS 风控阈值与跟单信号。

批量拉取多市场报价与 1 分钟到月线 K 线，搭研究看板、敞口监控与情报产品。

按时间序拉取逐笔与多周期历史，字段与实时流对齐，减少仿真和实盘之间的落差。

把报价和 K 线封装成 Function Calling / MCP 工具，让 Agent 回答带时间戳、可追溯。

套餐建议按“需要的市场是否实时”来定；配额与权益以定价页和控制台为准。

场景	主要数据	核心接口	需要关注的限制	建议起步
交易平台	tick、报价、成交增量	WS stream + quote 首屏快照	WebSocket 连接数 / 产品数上限	Pro（全市场实时）
数据分析	批量报价、多周期 K 线	quote（单次最多 50 个代码）+ 各市场 kline	REST 每分钟限额（RPM）	Growth；需股票实时选 Pro
回测	逐笔历史、OHLCV	各市场 kline（limit 1–1000）	月调用量、历史深度	Pro（含逐笔历史与回测数据）
AI Agent	按需快照、短期 K 线	quote / kline 封装为工具	Agent 重试导致的 429	免费版跑原型，上线按市场选档

换场景不用换接入方式，下面这些规则在每个端点上都一样。

请求头 X-API-Key，也可用 Authorization: Bearer。可为不同环境创建多把密钥并随时轮换。

所有端点返回 succ / data / msg / code，响应头带 X-Request-Id 便于排查。

WebSocket 只有握手计入日配额与 RPM，之后的 tick 推送不再重复计次。

默认 RPM 约 Free 30、Growth 120、Pro 600、企业版 3000；触发 429 时按 Retry-After 退避。

注册即得 API Key，无需信用卡；上线前再按市场与实时性选套餐。