Home Notices Documents Classes Download Others Rice
Classes  >  zaifapi  >  GetPositions(string,string,int,string)
zaifapi クラス : GetPositions(string,string,int,string) メソッド

説明

ユーザー自身の取引履歴を取得します。

構文

zaifapiInstance.GetPositions(string type, string groupId, int count, string currencyPair)

引数

クラス名前説明
stringtype"margin" か "futures"。
stringgroupIdグループ識別子。
intcount取得するレコード数。
stringcurrencyPair通貨ペア。

返り値

クラス説明
stringJSON文字列。

サンプルコード

1:

string apiKey = "3622c294-zs5m-587w-vv7j-sdf454h1sdbl";

2:

string secretKey = "4be789k3-dd7r-9d23-jy45-qng4c83hjk1g";

3:

zaifapi zaifapiIns = new zaifapi(apiKey, secretKey);

4:

string jsonStr = zaifapiIns.GetPositions("futures", "1", 10, "btc_jpy");

JSON-text 例

{"success": 1, "return": {"6185413": {"group_id": 1, "currency_pair": "btc_jpy", "action": "bid", "amount": 0.001, "price": 810000.0, "limit": 860000.0, "stop": 780000.0, "timestamp": "1558280346", "leverage": 5.0, "fee_spent": 0.0, "timestamp_closed": "1558281875", "deposit_jpy": 176.14, "refunded_jpy": 176.14, "swap": 0.0}, "6176292": {"group_id": 1, "currency_pair": "btc_jpy", "action": "bid", "amount": 0.001, "price": 790000.0, "limit": 865000.0, "stop": 785000.0, "timestamp": "1558238180", "leverage": 5.0, "fee_spent": 0.0, "timestamp_closed": "1558248455", "deposit_jpy": 176.24, "refunded_jpy": 176.24, "swap": 0.0}, "6175974": {"group_id": 1, "currency_pair": "btc_jpy", "action": "bid", "amount": 0.001, "price": 800000.0, "timestamp": "1558237296", "leverage": 5.0, "fee_spent": 0.0, "timestamp_closed": "1558237560", "deposit_jpy": 174.5, "refunded_jpy": 174.5, "swap": 0.0}, "5968352": {"group_id": 1, "currency_pair": "btc_jpy", "action": "ask", "amount": 0.0318, "price": 617890.0, "limit": 634000.0, "stop": 632890.0, "timestamp": "1556985859", "leverage": 25.0, "fee_spent": 7.7301666, "timestamp_closed": "1557003795", "price_avg": 617890.0, "amount_done": 0.0318, "close_avg": 634000.0, "close_done": 0.0318, "deposit_jpy": 792.8376, "refunded_jpy": 338.02651857, "swap": 65.21708517}, "5967856": {"group_id": 1, "currency_pair": "btc_jpy", "action": "ask", "amount": 0.0317, "price": 619995.0, "limit": 618410.0, "stop": 629995.0, "timestamp": "1556981067", "leverage": 25.0, "fee_spent": 7.7367654, "timestamp_closed": "1556982256", "price_avg": 619995.0, "amount_done": 0.0317, "close_avg": 618410.0, "close_done": 0.0317, "deposit_jpy": 793.5144, "refunded_jpy": 838.20219531, "swap": 2.18006071}, "5966678": {"group_id": 1, "currency_pair": "btc_jpy", "action": "ask", "amount": 0.0313, "price": 628000.0, "limit": 625000.0, "stop": 638000.0, "timestamp": "1556977646", "leverage": 25.0, "fee_spent": 0.0, "timestamp_closed": "1556977815", "deposit_jpy": 795.1452, "refunded_jpy": 795.1452, "swap": 0.0}, "5964938": {"group_id": 1, "currency_pair": "btc_jpy", "action": "bid", "amount": 0.0319, "price": 635020.0, "limit": 631000.0, "stop": 625020.0, "timestamp": "1556956920", "leverage": 25.0, "fee_spent": 8.0082717, "timestamp_closed": "1556959693", "price_avg": 635020.0, "amount_done": 0.0319, "close_avg": 636000.0, "close_done": 0.0319, "deposit_jpy": 821.3612, "refunded_jpy": 844.6149283, "swap": 0.0}, "5960557": {"group_id": 1, "currency_pair": "btc_jpy", "action": "ask", "amount": 0.0031, "price": 641030.0, "limit": 638030.0, "stop": 651030.0, "timestamp": "1556913528", "leverage": 2.5, "fee_spent": 0.0, "timestamp_closed": "1556913595", "deposit_jpy": 790.128, "refunded_jpy": 790.128, "swap": 0.0}, "5960548": {"group_id": 1, "currency_pair": "btc_jpy", "action": "ask", "amount": 0.0124, "price": 641000.0, "limit": 638000.0, "stop": 651000.0, "timestamp": "1556913441", "leverage": 10.0, "fee_spent": 0.0, "timestamp_closed": "1556913463", "deposit_jpy": 790.748, "refunded_jpy": 790.748, "swap": 0.0}, "5960543": {"group_id": 1, "currency_pair": "btc_jpy", "action": "ask", "amount": 0.0012, "price": 641600.0, "limit": 638600.0, "stop": 651600.0, "timestamp": "1556913367", "leverage": 1.0, "fee_spent": 0.0, "timestamp_closed": "1556913383", "deposit_jpy": 765.48, "refunded_jpy": 765.48, "swap": 0.0}}}

注意

レバレッジ取引APIです。API キーと、秘密キーを設定しなければ情報を取得できません。

type 引数に "margin" を指定した場合は現物の信用取引の取引履歴を取得します。この場合、groupId 引数には空文字列を指定してください。

type 引数に "futures" を指定した場合は AirFX の取引履歴を取得します。この場合、groupId 引数には "1" を指定してください。

count 引数に 0 以下の数値を指定した場合、最大 1000 件の取引履歴が返ります。

currencyPair 引数に空文字列を指定した場合、全通貨ペアの取引履歴が返ります。ただし、レバレッジ取引は "btc_jpy" だけで有効なので "btc_jpy" を指定したのと同じ結果になります。

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

{"success": 0, "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" は、それぞれの例外で異なります。

参照リンク

Copyright © Rice All rights reserved.