本文主要面向金融科技开发者，介绍如何对接全球主流金融市场的实时行情数据。
一、对接前准备
1.1 行情服务地址选择
选择数据服务商时，需要考虑以下关键因素：
- 数据覆盖范围（外汇、国际期货、国内期货、股指期货、股票、美股、港股、台股、贵金属、数字货币等）
- 数据延迟和稳定性
- API接口的易用性和文档完整性
- 技术支持响应速度
1.2 行情数据测试地址
该地址数据品类比较全，并且部分产品提供免费的测试接口：
- 测试地址：脉动行情数据-全面的行情数据接口
1.2 技术选型建议
- 网络通信：Netty + WebSocket（实时数据）
- 数据解析：Jackson/Gson（JSON处理）
- 连接管理：自定义连接池
- 数据存储：Redis（缓存）+ MySQL/TDengine（持久化）
- 消息队列：Kafka/RocketMQ（数据分发）
二、WebSocket实时行情推送
2.1 核心代码实现
2.1.1 客户端连接管理（Client.java）
public class Client {
private Channel channel;
private Bootstrap boot;
private Handler handler;
private EventLoopGroup group = new NioEventLoopGroup();
private final String host = "行情服务器地址";
private final int port = 端口号;
public Client() {
handler = new Handler(this);
boot = new Bootstrap();
boot.group(group)
.channel(NioSocketChannel.class)
.handler(new ChannelInitializer<SocketChannel>() {
@Override
protected void initChannel(SocketChannel ch) {
ChannelPipeline pipeline = ch.pipeline();
pipeline.addLast(new HttpClientCodec());
pipeline.addLast(new HttpObjectAggregator(65536));
pipeline.addLast(new IdleStateHandler(0, 10, 180, TimeUnit.SECONDS));
pipeline.addLast("handler", handler);
}
});
}
public void doConnect() {
if (channel != null && channel.isActive()) return;
ChannelFuture cf = boot.connect(host, port);
cf.addListener((ChannelFuture future) -> {
if (future.isSuccess()) {
channel = future.channel();
System.out.println("Connected successfully");
// 连接成功后立即发送订阅请求
sendSubscriptionRequest();
} else {
System.out.println("Connection failed, retrying in 3s");
future.channel().eventLoop().schedule(this::doConnect, 3, TimeUnit.SECONDS);
}
});
}
private void sendSubscriptionRequest() {
if (channel != null && channel.isActive()) {
String subscribeMsg = "{"Key": "btcusdt,ethusdt,xrpusdt"}";
channel.writeAndFlush(new TextWebSocketFrame(subscribeMsg));
}
}
}
2.1.2 消息处理器（Handler.java）
public class Handler extends SimpleChannelInboundHandler<Object> {
private final Client client;
public Handler(Client client) {
this.client = client;
}
@Override
protected void channelRead0(ChannelHandlerContext ctx, Object msg) {
if (msg instanceof TextWebSocketFrame) {
String jsonStr = ((TextWebSocketFrame) msg).text();
JSONObject json = JSONObject.parseObject(jsonStr);
// 处理心跳响应
if (json.containsKey("pong")) {
handlePongResponse(json.getLongValue("pong"));
return;
}
// 处理行情数据
if (json.containsKey("body")) {
JSONObject body = json.getJSONObject("body");
processMarketData(body);
}
} else if (msg instanceof BinaryWebSocketFrame) {
// 处理二进制数据
processBinaryData((BinaryWebSocketFrame) msg);
}
}
private void processMarketData(JSONObject body) {
String stockCode = body.getString("StockCode");
double price = body.getDoubleValue("Price");
double open = body.getDoubleValue("Open");
double high = body.getDoubleValue("High");
double low = body.getDoubleValue("Low");
long volume = body.getLongValue("TotalVol");
// 数据持久化或推送至业务系统
MarketData marketData = new MarketData(stockCode, price, open, high, low, volume);
DataProcessor.getInstance().process(marketData);
System.out.println(String.format("%s: %.4f (O:%.4f H:%.4f L:%.4f V:%d)",
stockCode, price, open, high, low, volume));
}
private void handlePongResponse(long timestamp) {
// 更新最后心跳时间
HeartbeatManager.updateLastPongTime(timestamp);
}
@Override
public void userEventTriggered(ChannelHandlerContext ctx, Object evt) {
if (evt instanceof IdleStateEvent) {
IdleStateEvent event = (IdleStateEvent) evt;
if (event.state() == IdleState.WRITER_IDLE) {
// 发送心跳包
sendHeartbeat(ctx);
}
}
}
private void sendHeartbeat(ChannelHandlerContext ctx) {
long timestamp = System.currentTimeMillis() / 1000;
String heartbeat = String.format("{"ping": %d}", timestamp);
ctx.writeAndFlush(new TextWebSocketFrame(heartbeat));
}
@Override
public void channelInactive(ChannelHandlerContext ctx) {
System.out.println("Connection lost, reconnecting...");
ctx.executor().schedule(client::doConnect, 1, TimeUnit.SECONDS);
}
}
2.2 心跳机制维护
为确保连接稳定性，需要实现完善的心跳机制：
public class HeartbeatManager {
private static long lastPongTime = System.currentTimeMillis();
public static void updateLastPongTime(long timestamp) {
lastPongTime = System.currentTimeMillis();
}
public static boolean isConnectionAlive() {
return System.currentTimeMillis() - lastPongTime < 30000; // 30秒超时
}
}
2.3 数据订阅管理
支持动态订阅和取消订阅：
public class SubscriptionManager {
private Set<String> subscribedSymbols = new ConcurrentHashSet<>();
public void subscribe(List<String> symbols) {
if (symbols == null || symbols.isEmpty()) return;
subscribedSymbols.addAll(symbols);
String subscriptionMsg = buildSubscriptionMessage(symbols);
sendToServer(subscriptionMsg);
}
public void unsubscribe(List<String> symbols) {
symbols.forEach(subscribedSymbols::remove);
String unsubscribeMsg = buildUnsubscriptionMessage(symbols);
sendToServer(unsubscribeMsg);
}
private String buildSubscriptionMessage(List<String> symbols) {
JSONObject json = new JSONObject();
json.put("action", "subscribe");
json.put("symbols", String.join(",", symbols));
return json.toJSONString();
}
}
2.4 断线重连策略
实现智能重连机制：
public class ReconnectionStrategy {
private static final int[] RETRY_INTERVALS = {1, 3, 5, 10, 30, 60}; // 重试间隔(秒)
private int retryCount = 0;
public long getNextRetryInterval() {
if (retryCount >= RETRY_INTERVALS.length) {
retryCount = RETRY_INTERVALS.length - 1;
}
return RETRY_INTERVALS[retryCount++];
}
public void reset() {
retryCount = 0;
}
}
三、K线数据接口
3.1 接口规范
RESTful API提供历史K线数据查询，支持多种时间周期。
3.2 请求示例
GET http://39.107.99.235:1008/redis.php?code=fx_sgbpusd&time=1m&rows=40
3.3 参数说明
| 参数 | 说明 | 可选值 |
|---|---|---|
| code | 产品代码 | 详见各市场代码列表 |
| time | K线周期 | 1m,5m,15m,30m,1h,1d,1M |
| rows | 获取条数 | 1m:600条, 其他:300条 |
3.4 响应数据解析
public class KLineData {
private long timestamp; // 时间戳(毫秒)
private double open; // 开盘价
private double high; // 最高价
private double low; // 最低价
private double close; // 收盘价
private String formatTime; // 格式化时间
private long volume; // 成交量
public static List<KLineData> parseFromJson(String jsonStr) {
JSONArray jsonArray = JSONArray.parseArray(jsonStr);
List<KLineData> result = new ArrayList<>();
for (int i = 0; i < jsonArray.size(); i++) {
JSONArray item = jsonArray.getJSONArray(i);
KLineData data = new KLineData();
data.setTimestamp(item.getLong(0));
data.setOpen(item.getDouble(1));
data.setHigh(item.getDouble(2));
data.setLow(item.getDouble(3));
data.setClose(item.getDouble(4));
data.setFormatTime(item.getString(5));
data.setVolume(item.getLong(6));
result.add(data);
}
return result;
}
}
四、数据字段说明
4.1 实时行情核心字段
| 字段名 | 说明 | 数据类型 |
|---|---|---|
| StockCode | 产品代码 | String |
| Price | 最新价 | Double |
| Open | 当日开盘价 | Double |
| LastClose | 昨日收盘价 | Double |
| High | 当日最高价 | Double |
| Low | 当日最低价 | Double |
| Time | 更新时间 | String |
| LastTime | 时间戳 | Long |
| BP1/BV1 | 买一价/量 | Double/Long |
| SP1/SV1 | 卖一价/量 | Double/Long |
| TotalVol | 当日成交量 | Long |
| DiffRate | 涨跌幅 | Double |
| Diff | 涨跌额 | Double |
4.2 深度数据（Market Depth）
public class DepthData {
private String symbol;
private List<DepthItem> bids = new ArrayList<>(); // 买盘
private List<DepthItem> asks = new ArrayList<>(); // 卖盘
private long timestamp;
public static class DepthItem {
private double price;
private double quantity;
// getter/setter
}
}
4.3 成交数据（Trade）
| 字段 | 说明 | 类型 |
|---|---|---|
| time | 成交时间 | Long |
| price | 成交价格 | Double |
| size | 成交数量 | Double |
| direction | 方向(1:卖, 2:买) | Integer |
五、总结
通过本文介绍的Java API对接方案，开发者可以快速、稳定地接入全球金融市场的实时行情数据。关键实施要点包括：
- 连接稳定性：通过心跳检测、断线重连、异常处理确保7x24小时稳定运行
- 数据准确性：实现数据校验机制，防止异常数据影响业务逻辑
- 性能优化：使用Netty异步IO、连接池、数据压缩等技术提升吞吐量
- 扩展性设计：模块化设计支持多种市场、多种数据类型的灵活扩展
这种技术方案特别适合需要实时行情数据的量化交易系统、行情分析软件、金融信息平台和风险管理系统使用。在实际应用中，建议根据具体业务需求进行性能调优和功能扩展。
