zaifapi クラス : GetPositions(string,string,int,string) メソッド
説明
ユーザー自身の取引履歴を取得します。
構文
zaifapiInstance.GetPositions(string type, string groupId, int count, string currencyPair)
引数
| クラス | 名前 | 説明 |
| string | type | "margin" か "futures"。 |
| string | groupId | グループ識別子。 |
| int | count | 取得するレコード数。 |
| string | currencyPair | 通貨ペア。 |
返り値
| クラス | 説明 |
| zaifres | 要求に対する応答、JSON文字列を持つ。 |
サンプルコード
| 1: | string apiKey = "3622c294-zs5m-587w-vv7j-sdf454h1sdbl"; |
| 2: | string secretKey = "4be789k3-dd7r-9d23-jy45-qng4c83hjk1g"; |
| 3: | zaifapi zaifapiIns = new zaifapi(apiKey, secretKey); |
| 4: | zaifres zaifresIns = zaifapiIns.GetPositions("futures", "1", 10, "btc_jpy"); |
| 5: | string jsonStr = zaifresIns.Result; |
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" を指定したのと同じ結果になります。
要求に対する応答として zaifres クラスのインスタンスが返ります。このインスタンスが応答の結果の JSON-text を保持しています。
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" は、それぞれの例外で異なります。