一、什麼是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 |
成交額 (千元) |
本站聲明:網站內容來源於博客園,如有侵權,請聯繫我們,我們將及時處理
【其他文章推薦】
※USB CONNECTOR掌控什麼技術要點? 帶您認識其相關發展及效能
※台北網頁設計公司這麼多該如何選擇?
※智慧手機時代的來臨,RWD網頁設計為架站首選
※評比南投搬家公司費用收費行情懶人包大公開
※幫你省時又省力,新北清潔一流服務好口碑
※回頭車貨運收費標準