---
# System prepended metadata

title: 股票价格API需求

---

# 股票价格API需求

## 1. 获取股票价格
### 1.1 数据请求
- URL: [https://query.kalata.io/api/finance/spark](https://query.kalata.io/api/finance/spark)
- 请求方式: GET
- 参数说明:
>| 参数名|必填|类型|说明|
>| -----| ---- | ------ |--|
>| symbols|是|string|股票的symbol代码,多个股票用逗号分割|
- 示例: https://query.kalata.io/api/finance/spark?symbols=BIDU,TSLA,ARKK,SPCE,PACB
- 参考:https://query1.finance.yahoo.com/v7/finance/spark?symbols=BIDU,TSLA,ARKK,SPCE,PACB&range=1d&interval=1d&indicators=close

### 1.2 返回数据
```javascript=
{
    "code": 200,  // 200表示返回成功,其他code代表失败, 参考 http response status code
    "message": "Success", // 如果成功,返回"Success", 如果失败返回失败原因
    "data": [
        {
            "symbol": "BIDU", //股票代码
            "marketPrice": 104.18, //当前价格
            "previousClose": 99.48 //上一个交易日的close价格
        },
        {
            "symbol": "TSLA", 
            "marketPrice": 104222.18, 
            "previousClose": 99222.48 
        },        
        {
            //......
        }
    ]
}
``` 

 
## 2. 获取股票历史数据
### 2.1 数据请求
- URL: [https://query.kalata.io/api/finance/chart](https://query.kalata.io/api/finance/chart)
- 请求方式: GET
- 参数说明:
>| 参数名|必填|类型|说明|
>| -----| ---- | ------ |--|
>| symbol|是|string|股票的symbol代码|
>| from|是|timestamp|查询开始时间戳|
>| to|是|timestamp|查询结束时间戳|
>| interval|是|string|数据间隔(1m,1h,1d,1w)|
- 示例: https://query.kalata.io/api/finance/chart?symbol=BIDU&from=1620920940&to=1621218054&interval=1h
- 参考: https://query1.finance.yahoo.com/v8/finance/chart/BIDU?symbol=BIDU&period1=1620920940&period2=1621218054&interval=1m
### 2.2 返回数据
```javascript=
{
    "code": 200,  // 200表示返回成功,其他code代表失败, 参考 http response status code
    "message": "Success", // 如果成功,返回"Success", 如果失败返回失败原因
    "data": [
        [1620924600,17.1,19.2,17.4,18.1], //time,low,high,open,close
        ........
    ]
}
``` 

 