利用Tu Share获取股票交易信息,c#实现
一、什么是Tu Share
Tushare是一个免费、开源的python财经数据接口包。主要实现对股票等金融数据从数据采集、清洗加工 到 数据存储的过程,用户可以免费(部分数据的下载有积分限制)的通过它提供的财经接口获取股票交易、期货等财经信息,功能非常强大。该接口和直接到各财经网站爬数据相比,最大的优势就是快,去传统财经网站爬数据,好多关键性的股票信息只能一只股一只股爬,而Tu Share的API,一个调用可以获得一天的全部数据,速度差了好几个数量级。另外一方面各财经网站的接口的API没有对外文档化,随时可能变化,而Tu Share的API有正式的文档化相对比较稳定。
二、如何注册
该网站使用积分制来控制数据的访问权限,如果想要访问数据,先要到下面这个网址完成注册,https://tushare.pro/register。注册完成后,可以需要到个人主页中拷贝Token,这个Token会在以后的访问中用到,步骤如下
1、登录成功后,点击右上角->个人主页
2、 在“用户中心”中点击“接口TOKEN”
3、 可以点击右侧复制按钮复制token
三、Http API说明
Tushare HTTP数据获取的方式,采用了post的机制,通过提交JSON body参数,就可以获得您想要的数据。具体参数说明如下:
输入参数
api_name:接口名称,比如stock_basic
token :用户唯一标识,可通过登录pro网站获取
params:接口参数,如daily接口中start_date和end_date
fields:字段列表,用于接口获取指定的字段,以逗号分隔,如"open,high,low,close"
输出参数
code: 接口返回码,2002表示权限问题。
msg:错误信息,比如“系统内部错误”,“没有权限”等
data:数据,data里包含fields和items字段,分别为字段和数据内容
四、c#(.net core)实现
1、在Visual Studio中安装下面几个包:Microsoft.Extensions.Http、Newtonsoft.Json
2、封装方法,实现对REST web service的调用
public interface IHttpClientUtility { string HttpClientPost(string url, object datajson); }
public class HttpClientUtility : IHttpClientUtility { public HttpClientUtility() { } public string HttpClientPost(string url, object datajson) { using (HttpClient httpClient = new HttpClient()) //http对象 { httpClient.DefaultRequestHeaders.Accept.Clear(); httpClient.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json")); httpClient.Timeout = new TimeSpan(0, 0, 5); //转为链接需要的格式 HttpContent httpContent = new JsonContent(datajson); //请求 HttpResponseMessage response = httpClient.PostAsync(url, httpContent).Result; if (response.IsSuccessStatusCode) { Task<string> t = response.Content.ReadAsStringAsync(); return t.Result; } throw new Exception("调用失败"); } } }
public class JsonContent : StringContent { public JsonContent(object value) : base(JsonConvert.SerializeObject(value), Encoding.UTF8, "application/json") { } public JsonContent(object value, string mediaType) : base(JsonConvert.SerializeObject(value), Encoding.UTF8, mediaType) { } }
3、封装对Tu Share API的调用
public class TuShareUtility { private IHttpClientUtility _httpClientUtility; private string _url = "http://api.waditu.com/"; public TuShareUtility(IHttpClientUtility httpClientUtility) { _httpClientUtility = httpClientUtility; } /// <summary> /// 调用TuShare API /// </summary> /// <param name="apiName"></param> /// <param name="parmaMap"></param> /// <param name="fields"></param> /// <returns></returns> public DataTable GetData(string apiName,Dictionary<string,string> parmaMap,params string[] fields) { var tuShareParamObj=new TuShareParamObj(){ ApiName = apiName ,Params = parmaMap,Fields = string.Join(",",fields)}; //做Http调用 var result=_httpClientUtility.HttpClientPost(_url, tuShareParamObj); //将返回结果序列化成对象 var desResult=JsonConvert.DeserializeObject<TuShareResult>(result); //如果调用失败,抛出异常 if(!string.IsNullOrEmpty(desResult.Msg)) throw new Exception(desResult.Msg); //返回结果分成两部分,一部分是列头信息,另一部分是数据本身,用这两部分数据可以构建DataTable DataTable dt = new DataTable(); foreach (var dataField in desResult.Data.Fields) { dt.Columns.Add(dataField); } foreach (var dataItemRow in desResult.Data.Items) { var newdr=dt.NewRow(); for (int i=0;i< dataItemRow.Length;i++) { newdr[i] = dataItemRow[i]; } dt.Rows.Add(newdr); } return dt; } private class TuShareParamObj { [JsonProperty("api_name")] public string ApiName { get; set; } [JsonProperty("token")] public string Token { get; } = "****************";//你的Token [JsonProperty("params")] public Dictionary<string, string> Params { get; set; } [JsonProperty("fields")] public string Fields { get; set; } } private class TuShareData { [JsonProperty("fields")] public string[] Fields { get; set; } [JsonProperty("items")] public string[][] Items { get; set; } } private class TuShareResult { [JsonProperty("code")] public string Code { get; set; } [JsonProperty("msg")] public string Msg { get; set; } [JsonProperty("data")] public TuShareData Data { get; set; } } }
4、调用示例
获得日线行情,整个过程1秒左右,返回6月24日,股票相关交易信息,代码如下,(该网站的其它接口定义可以到https://tushare.pro/document/2查看)
var tuShareUtility=new TuShareUtility(); Dictionary<string, string> p = new Dictionary<string, string>(); p["trade_date"] = "20200624"; var table = tuShareUtility.GetData("daily", p, "");
返回如下结果
返回字段说明
名称 | 类型 | 描述 |
---|---|---|
ts_code | str | 股票代码 |
trade_date | str | 交易日期 |
open | float | 开盘价 |
high | float | 最高价 |
low | float | 最低价 |
close | float | 收盘价 |
pre_close | float | 昨收价 |
change | float | 涨跌额 |
pct_chg | float | 涨跌幅 (未复权,如果是复权请用 通用行情接口 ) |
vol | float | 成交量 (手) |
amount | float | 成交额 (千元) |
posted on 2020-06-27 17:21 Sunxianchun 阅读(1861) 评论(0) 编辑 收藏 举报