一、什麼是Tu Share

Tushare是一個免費、開源的python財經資料介面包。主要實現對股票等金融資料從資料採集、清洗加工到資料儲存的過程，使用者可以免費（部分資料的下載有積分限制）的通過它提供的財經介面獲取股票交易、期貨等財經資訊，功能非常強大。該介面和直接到各財經網站爬資料相比，最大的優勢就是快，去傳統財經網站爬資料，好多關鍵性的股票資訊只能一隻股一隻股爬，而Tu Share的API，一個呼叫可以獲得一天的全部資料，速度差了好幾個數量級。另外一方面各財經網站的介面的API沒有對外檔案化，隨時可能變化，而Tu Share的API有正式的檔案化相對比較穩定。

二、如何註冊

該網站使用積分制來控制資料的訪問許可權，如果想要訪問資料，先要到下面這個網址完成註冊，https://tushare.pro/register?reg=375890。註冊完成後，可以需要到個人主頁中拷貝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欄位，分別為欄位和資料內容

四、.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(, , );

                //轉為連結需要的格式

                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=;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日，股票相關交易資訊，程式碼如下

var tuShareUtility=new TuShareUtility();

Dictionary<string, string> p = new Dictionary<string, string>();

p["trade_date"] = "";

var table = tuShareUtility.GetData("daily", p, "");

返回如下結果

返回欄位說明