bitbankapi クラス : TradeHistory(string,long,long,long,long,string) メソッド
説明
約定履歴を取得します。
構文
bitbankapiInstance.TradeHistory(string currencyPair, long count, long orderId, long since, long end, string order)
引数
クラス | 名前 | 説明 |
string | currencyPair | 通貨ペア。 |
long | count | 取得数。 |
long | orderId | 取引ID。 |
long | since | 開始UNIXタイムスタンプ。 |
long | end | 終了UNIXタイムスタンプ。 |
string | order | 並び順。"asc" or "desc" |
返り値
クラス | 説明 |
bitbankres | 要求に対する応答、JSON文字列を持つ。 |
サンプルコード
1: | string apiKey = "3622c294-zs5m-587w-vv7j-sdf454h1sdbl"; |
2: | string secretKey = "4be789k3-dd7r-9d23-jy45-qng4c83hjk1g"; |
3: | bitbankapi bitbankapiIns = new bitbankapi(apiKey, secretKey); |
4: | bitbankres bitbankresIns = bitbankapiIns.TradeHistory("btc_jpy", 10L, 0L, 0L, 0L, ""); |
5: | string jsonStr = bitbankresIns.Result; |
JSON-text 例
{"success":1,"data":{"trades":[{"trade_id":23286271,"order_id":411169732,"pair":"btc_jpy","side":"buy","type":"market","amount":"0.0018","price":"790699","maker_taker":"taker","fee_amount_base":"0.00000000","fee_amount_quote":"0.0000","executed_at":1527541825000},{"trade_id":23286089,"order_id":411169354,"pair":"btc_jpy","side":"buy","type":"market","amount":"0.0040","price":"791861","maker_taker":"taker","fee_amount_base":"0.00000000","fee_amount_quote":"0.0000","executed_at":1527541772000},{"trade_id":23286087,"order_id":411169354,"pair":"btc_jpy","side":"buy","type":"market","amount":"0.0010","price":"791836","maker_taker":"taker","fee_amount_base":"0.00000000","fee_amount_quote":"0.0000","executed_at":1527541772000},{"trade_id":23285969,"order_id":411169026,"pair":"btc_jpy","side":"buy","type":"market","amount":"0.0250","price":"791871","maker_taker":"taker","fee_amount_base":"0.00000000","fee_amount_quote":"0.0000","executed_at":1527541724000},{"trade_id":22274881,"order_id":407381911,"pair":"btc_jpy","side":"sell","type":"market","amount":"0.0061","price":"917738","maker_taker":"taker","fee_amount_base":"0.00000000","fee_amount_quote":"0.0000","executed_at":1526989518000},{"trade_id":22274879,"order_id":407381911,"pair":"btc_jpy","side":"sell","type":"market","amount":"0.0100","price":"917739","maker_taker":"taker","fee_amount_base":"0.00000000","fee_amount_quote":"0.0000","executed_at":1526989518000},{"trade_id":22274877,"order_id":407381911,"pair":"btc_jpy","side":"sell","type":"market","amount":"0.0013","price":"917740","maker_taker":"taker","fee_amount_base":"0.00000000","fee_amount_quote":"0.0000","executed_at":1526989518000},{"trade_id":22274875,"order_id":407381911,"pair":"btc_jpy","side":"sell","type":"market","amount":"0.0013","price":"917865","maker_taker":"taker","fee_amount_base":"0.00000000","fee_amount_quote":"0.0000","executed_at":1526989518000},{"trade_id":22274873,"order_id":407381911,"pair":"btc_jpy","side":"sell","type":"market","amount":"0.0013","price":"917865","maker_taker":"taker","fee_amount_base":"0.00000000","fee_amount_quote":"0.0000","executed_at":1526989518000},{"trade_id":22274137,"order_id":407377888,"pair":"btc_jpy","side":"buy","type":"market","amount":"0.0200","price":"916255","maker_taker":"taker","fee_amount_base":"0.00000000","fee_amount_quote":"0.0000","executed_at":1526988919000}]}} |
注意
非公開APIです。API キーと、秘密キーを設定しなければ情報を取得できません。
有効な第一引数 : btc_jpy, xrp_jpy, ltc_btc, eth_btc, mona_jpy, mona_btc, bcc_jpy, bcc_btc
第二から第五引数が必要ないときは、ゼロ以下の数値を指定してください。その引数は無視されます。
該当する通貨ペアの全ての約定履歴を取得するには、第二引数にゼロ以下の数値を指定してください。
第六引数は、結果のJSON-text内の約定履歴の時刻による並び順です。"asc"(昇順)か"desc"(降順)を指定してください。必要ないときは、空文字列を指定すれば無視されます。その場合の並び順は、降順("desc" : デフォルト値)になります。
要求に対する応答として bitbankres クラスのインスタンスが返ります。このインスタンスが応答の結果の JSON-text を保持しています。
引数が正しくない場合、以下の様な JSON-text が返ります。
{"success":0,"data":{"code":xxxxx}}
"code" は、それぞれのエラーで異なる番号になります。
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" は、それぞれの例外で異なります。