印度数据源 Java 对接文档

本文将指导开发者通过 Java 对接印度股票、外汇、期货及加密货币市场数据接口，覆盖核心 API 调用、参数说明和数据处理逻辑。基于官方 JSON 文档整理，所有接口均需使用 [key=联系我们获取key](https://t.me/stocktvpaopao) 授权。接口文档

---

1. 股票市场接口

适用场景：印度（countryId=14）、马来西亚、印尼等国家股票行情
核心 API 列表：

功能	端点	参数说明	返回字段示例
市场列表	GET /stock/stocks	countryId=14（印度）	symbol, last, chgPct
单股查询	GET /stock/queryStocks	id=7310（股票PID）	fundamentalRevenue, high
指数行情	GET /stock/indices	countryId=14	name, last, chgPct
K线数据	GET /stock/kline	pid=7310&interval=PT15M	time, open, close
IPO新股日历	GET /stock/getIpo	countryId=14	ipoListing, company
涨跌排行榜	GET /stock/updownList	type=1（1=涨幅榜）	chgPct, volume
公司信息	GET /stock/companies	page=1&pageSize=10	industry, employeeCount

Java 示例（使用 Spring Boot）

import org.springframework.web.client.RestTemplate;

public class StockAPI {
    private static final String BASE_URL = "https://api.stocktv.top/stock";
    private static final String API_KEY = "联系我们获取key";

    // 获取印度股票市场列表
    public String getStockList() {
        RestTemplate restTemplate = new RestTemplate();
        String url = BASE_URL + "/stocks?countryId=14&page=1&key=" + API_KEY;
        return restTemplate.getForObject(url, String.class);
    }

    // 获取股票K线数据
    public String getKlineData(String pid, String interval) {
        String url = String.format("%s/kline?pid=%s&interval=%s&key=%s", 
                                  BASE_URL, pid, interval, API_KEY);
        return new RestTemplate().getForObject(url, String.class);
    }
}

---

2. 外汇接口

核心功能：印度卢比（INR）交叉汇率
关键接口：

功能	端点	参数说明
实时汇率列表	GET /market/currency	countryType=sg（可选）
K线图表数据	GET /market/chart	symbol=EURUSD=X&interval=5m

数据示例：

{
  "code": 200,
  "data": [
    {
      "symbol": "EURUSD=X",
      "chg": "+0.0016",
      "chgPct": "+0.15%",
      "lastPrice": "1.0765"
    }
  ]
}

---

3. 期货市场接口

支持品种：新加坡铁矿石（FEF）、马棕油（FCPO）等
核心端点：

// 获取期货行情
public String getFuturesData(String symbol) {
    String url = "https://api.stocktv.top/futures/querySymbol?symbol=" + symbol + "&key=" + API_KEY;
    return new RestTemplate().getForObject(url, String.class);
}

---

4. 加密货币接口

对接币安数据：

功能	端点	参数说明
最新价格	GET /crypto/lastPrice	symbols=BTCUSDT,ETHUSDT
K线数据	GET /crypto/getKlines	interval=5m（1s~1M）

Java 调用示例：

public String getCryptoPrice(String symbols) {
    String url = "https://api.stocktv.top/crypto/lastPrice?symbols=" + symbols + "&key=" + API_KEY;
    return new RestTemplate().getForObject(url, String.class);
}

---

5. WebSocket 实时推送

连接方式：

import javax.websocket.*;
import java.net.URI;

@ClientEndpoint
public class StockWebSocket {
    private static final String WS_URL = "wss://ws-api.stocktv.top/connect?key=联系我们获取key";

    @OnMessage
    public void onMessage(String message) {
        System.out.println("Received: " + message); // 实时行情推送
    }

    public static void main(String[] args) throws Exception {
        WebSocketContainer container = ContainerProvider.getWebSocketContainer();
        container.connectToServer(StockWebSocket.class, URI.create(WS_URL));
    }
}

返回数据字段：

• pid：产品ID
• last_numeric：最新价
• pcp：涨跌幅
• volume：成交量

---

注意事项

1. 鉴权：所有请求需携带 key 参数。
2. 频率限制：未公开说明，建议主动限流（如 10 请求/秒）。
3. 错误处理：检查返回 JSON 中的 code 字段（200=成功）。
4. 时区：时间戳均为 UTC 时间，需转换为印度时区（IST, UTC+5:30）。

通过以上接口，开发者可快速构建印度市场的股票、外汇、期货及加密货币数据服务。完整文档请参考原始 JSON 结构。