zaifapi クラス : SwapHistory(string,string,string) メソッド

説明

スワップポイント履歴を取得します。

構文

zaifapiInstance.SwapHistory(string groupId, string currencyPair, string page)

引数

クラス	名前	説明
string	groupId	グループ識別子。
string	currencyPair	通貨ペア。
string	page	ページ番号。

返り値

クラス	説明
zaifres	要求に対する応答、JSON文字列を持つ。

サンプルコード

1:	zaifapi zaifapiIns = new zaifapi();
2:	zaifres zaifresIns = zaifapiIns.SwapHistory("1", "btc_jpy", "");
3:	string jsonStr = zaifresIns.Result;

JSON-text 例

groupId : "1" currencyPair : "btc_jpy" page : "1"

[{"timestamp": 1558213200, "swap_rate_bid": -0.36757897, "swap_rate_ask": 0.36757897}, {"timestamp": 1558206000, "swap_rate_bid": -0.22539726, "swap_rate_ask": 0.22539726}, {"timestamp": 1558198800, "swap_rate_bid": -0.2774411, "swap_rate_ask": 0.2774411}, {"timestamp": 1558191600, "swap_rate_bid": 0.03443902, "swap_rate_ask": -0.03443902}, {"timestamp": 1558184400, "swap_rate_bid": 0.0, "swap_rate_ask": 0.0}, {"timestamp": 1558177200, "swap_rate_bid": -0.11678152, "swap_rate_ask": 0.11678152}, {"timestamp": 1558170000, "swap_rate_bid": -0.11166682, "swap_rate_ask": 0.11166682}, {"timestamp": 1558162800, "swap_rate_bid": 0.02827941, "swap_rate_ask": -0.02827941}, {"timestamp": 1558155600, "swap_rate_bid": -0.36449307, "swap_rate_ask": 0.36449307}, {"timestamp": 1558148400, "swap_rate_bid": -0.15303854, "swap_rate_ask": 0.15303854}, {"timestamp": 1558141200, "swap_rate_bid": 0.0, "swap_rate_ask": 0.0}, {"timestamp": 1558134000, "swap_rate_bid": -0.0328427, "swap_rate_ask": 0.0328427}, {"timestamp": 1558126800, "swap_rate_bid": 0.0, "swap_rate_ask": 0.0}, {"timestamp": 1558119600, "swap_rate_bid": -0.375, "swap_rate_ask": 0.375}, {"timestamp": 1558112400, "swap_rate_bid": -0.24189983, "swap_rate_ask": 0.24189983}, {"timestamp": 1558105200, "swap_rate_bid": 0.16732218, "swap_rate_ask": -0.16732218}, {"timestamp": 1558098000, "swap_rate_bid": -0.375, "swap_rate_ask": 0.375}, {"timestamp": 1558090800, "swap_rate_bid": -0.21627629, "swap_rate_ask": 0.21627629}, {"timestamp": 1558083600, "swap_rate_bid": -0.20980547, "swap_rate_ask": 0.20980547}, {"timestamp": 1558076400, "swap_rate_bid": -0.08380595, "swap_rate_ask": 0.08380595}, {"timestamp": 1558069200, "swap_rate_bid": 0.375, "swap_rate_ask": -0.375}, {"timestamp": 1558062000, "swap_rate_bid": 0.375, "swap_rate_ask": -0.375}, {"timestamp": 1558054800, "swap_rate_bid": -0.22519664, "swap_rate_ask": 0.22519664}, {"timestamp": 1558047600, "swap_rate_bid": 0.01957902, "swap_rate_ask": -0.01957902}]

groupId : "1" currencyPair : "btc_jpy" page : ""

groupId : "2" currencyPair : "btc_jpy" page : "1"

[{"timestamp": 1498834800, "swap_rate_bid": 0.0, "swap_rate_ask": 0.0}, {"timestamp": 1498748400, "swap_rate_bid": 0.0, "swap_rate_ask": 0.0}, {"timestamp": 1498662000, "swap_rate_bid": 0.0, "swap_rate_ask": 0.0}, {"timestamp": 1498575600, "swap_rate_bid": 0.0, "swap_rate_ask": 0.0}, {"timestamp": 1498489200, "swap_rate_bid": 0.0, "swap_rate_ask": 0.0}, {"timestamp": 1498402800, "swap_rate_bid": 0.0, "swap_rate_ask": 0.0}, {"timestamp": 1498316400, "swap_rate_bid": 0.0, "swap_rate_ask": 0.0}, {"timestamp": 1498230000, "swap_rate_bid": 0.0, "swap_rate_ask": 0.0}, {"timestamp": 1498143600, "swap_rate_bid": 0.0, "swap_rate_ask": 0.0}, {"timestamp": 1498057200, "swap_rate_bid": 0.0, "swap_rate_ask": 0.0}, {"timestamp": 1497970800, "swap_rate_bid": 0.0, "swap_rate_ask": 0.0}, {"timestamp": 1497884400, "swap_rate_bid": 0.0, "swap_rate_ask": 0.0}, {"timestamp": 1497798000, "swap_rate_bid": 0.0, "swap_rate_ask": 0.0}, {"timestamp": 1497711600, "swap_rate_bid": 0.0, "swap_rate_ask": 0.0}, {"timestamp": 1497625200, "swap_rate_bid": 0.0, "swap_rate_ask": 0.0}, {"timestamp": 1497538800, "swap_rate_bid": 0.0, "swap_rate_ask": 0.0}, {"timestamp": 1497452400, "swap_rate_bid": 0.0, "swap_rate_ask": 0.0}, {"timestamp": 1497366000, "swap_rate_bid": 0.0, "swap_rate_ask": 0.0}, {"timestamp": 1497279600, "swap_rate_bid": 0.0, "swap_rate_ask": 0.0}, {"timestamp": 1497193200, "swap_rate_bid": 0.0, "swap_rate_ask": 0.0}, {"timestamp": 1497106800, "swap_rate_bid": 0.0, "swap_rate_ask": 0.0}, {"timestamp": 1497020400, "swap_rate_bid": 0.0, "swap_rate_ask": 0.0}, {"timestamp": 1496934000, "swap_rate_bid": 0.0, "swap_rate_ask": 0.0}, {"timestamp": 1496847600, "swap_rate_bid": 0.0, "swap_rate_ask": 0.0}]

groupId : "2" currencyPair : "btc_jpy" page : ""

注意

先物公開APIです。API キーと秘密キーを設定しなくても情報を取得できます。

groupId 引数には "1" 以上の数値文字列を指定してください。"all" と "active" は指定できません。

groupId 引数に "1"、currencyPair 引数に "btc_jpy" を指定すると AirFX のスワップポイント履歴が返ります。

groupId 引数に "2" 以上の数値文字列、currencyPair 引数に "btc_jpy" を指定した場合、終了している先物取引に該当するものがあれば、そのスワップポイント履歴が返ります。

page 引数には空文字列か "1" から "100" までの数値文字列を指定してください。数値が小さいほど新しい履歴が返ります。空文字列は常に最新の履歴が返ります。

要求に対する応答として zaifres クラスのインスタンスが返ります。このインスタンスが応答の結果の JSON-text を保持しています。

API エラーが発生した場合、以下の様な JSON-text が返ります。

{"error": "..."}

"error" は、それぞれの API エラーで異なります。

HTTP エラーが発生した場合、以下の様な JSON-text が返ります。

{"success": -1000,"error": { "statuscode" : 404, "message": "Not Found"}}

"statuscode" と "message" は、それぞれの HTTP エラーで異なります。

要求がタイムアウトした場合、以下の JSON-text が返ります。

{"success": -1001,"error": { "typename" : "TaskCanceledException", "message": "タスクが取り消されました。"}}

その他の例外が発生して要求が失敗した場合、以下の様な JSON-text が返ります。

{"success": -1002,"error": { "typename" : "...", "message": "..."}}

"typename" と "message" は、それぞれの例外で異なります。

参照リンク

ZaifAPI ドキュメント