API 文档中心

ATG World Trading API

外汇和贵金属实时报价服务,支持 HTTP REST API 和 WebSocket 实时推送

实时报价

获取所有交易品种或指定品种的实时买卖报价

GET /api/quotes

历史数据

查询历史报价记录,支持自定义时间范围和记录数量

GET /api/quotes/history

WebSocket 推送

建立 WebSocket 连接,无需轮询即可接收实时报价更新

ws://localhost:5001

缓存状态

查看当前缓存中的品种列表和总数

GET /api/quotes/status

HTTP REST API

GET /api/quotes 获取所有品种的最新报价
{
  "time": "2026-01-15 09:30:00",
  "count": 8,
  "quotes": [
    {"symbol": "EURUSD", "bid": "1.08915", "ask": "1.08920"},
    {"symbol": "XAUUSD", "bid": "2034.00", "ask": "2034.50"}
  ]
}
GET /api/quotes/{symbols} 查询指定品种的报价

支持逗号分隔的多品种查询

// 单个品种GET /api/quotes/EURUSD

// 多个品种GET /api/quotes/EURUSD,GBPJPY,XAUUSD
GET /api/quotes/history 获取所有品种的历史报价

使用 count 参数限制每个品种的记录数(最多 100)

GET /api/quotes/history?count=50
GET /api/quotes/status 获取当前缓存状态

返回当前缓存中的品种列表和总数

WebSocket 实时推送

WS ws://localhost:5001 建立 WebSocket 连接

订阅消息格式

{
  "action": "subscribe",
  "symbols": ["EURUSD", "XAUUSD"]
}

// 响应{
  "type": "subscribed",
  "symbols": ["EURUSD", "XAUUSD"]
}

服务器推送示例

{
  "type": "quote",
  "data": {
    "symbol": "EURUSD",
    "bid": "1.08915",
    "ask": "1.08920",
    "digits": "5",
    "time": "2026-01-15T09:30:00"
  }
}

支持的交易品种

品种代码 品种名称 类型 小数位
EURUSD 欧元 / 美元 外汇 5
GBPJPY 英镑 / 日元 外汇 3
USDJPY 美元 / 日元 外汇 3
AUDUSD 澳元 / 美元 外汇 5
USDCAD 美元 / 加元 外汇 5
USDCHF 美元 / 瑞郎 外汇 5
NZDUSD 纽元 / 美元 外汇 5
XAUUSD 黄金 / 美元 贵金属 2