チケット(注文毎のポジション) エンドポイント


未決済チケットのリストを取得する

GET /v1/accounts/:account_id/trades

入力クエリパラメータ

maxId
任意 サーバーは、このIDとそれ以下のチケットを降順で返信します(paginationの為)。
count
任意 取得する未決済チケットの最大数。 デフォルトは50で、最大値は500。
instrument
任意 特定の銘柄に対する未決済チケットのみ取得します。 デフォルトは全ての銘柄(all)です。
ids
任意 URLエンコードされ、コンマで区切られた取得対象のチケットIDのリスト。 リストに設定できるIDの最大数は50です。 このパラメータが設定された場合は、他のパラメータは設定できません。

$curl -X GET "http://api-sandbox.oanda.com/v1/accounts/12345/trades?instrument=EUR_USD&count=2"

レスポンス

ヘッダ
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 449
Link: <http://api-sandbox.oanda.com/v1/accounts/12345/trades?count=2&instrument=EUR_USD&maxId=175427741>; rel="next"
X-Result-Count: 3
ボディ
{
  "trades" : [
    {
            "id" : 175427743,
            "units" : 2,
            "side" : "sell",
            "instrument" : "EUR_USD",
            "time" : "2014-02-13T17:47:57Z",
            "price" : 1.36687,
            "takeProfit" : 0,
            "stopLoss" : 0,
            "trailingStop" : 0
            "trailingAmount" : 0
    },
    {
            "id" : 175427742,
            "units" : 2,
            "side" : "sell",
            "instrument" : "EUR_USD",
            "time" : "2014-02-13T17:47:56Z",
            "price" : 1.36687,
            "takeProfit" : 0,
            "stopLoss" : 0,
            "trailingStop" : 0,
            "trailingAmount" : 0,
    }
  ]
}

Pagination(ページ割り)

チケットはcountとmaxIdパラメータによりページ割りができます。 一つのクエリで最大50件のチケットが返信されます。 もしチケットの件数がデフォルトもしくは指定された件数を上回っていた場合は、Linkヘッダと一緒にmaxIdが次のまだ未送信のチケットのIDに設定されたURLが返信されます。


特定のチケットに関する情報を取得する

GET /v1/accounts/:account_id/trades/:trade_id

$curl -X GET "http://api-sandbox.oanda.com/v1/accounts/12345/trades/43211"

レスポンス

ヘッダ
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 193
ボディ
{
  "id" : 43211,                          // The ID of the trade
  "units" : 5,                           // The number of units in the trade
  "side" : "buy",                        // The direction of the trade
  "instrument" : "EUR_USD",              // The symbol of the instrument of the trade
  "time" : "2013-07-03T14:30:38Z",       // The time of the trade (in RFC3339 format)
  "price" : 1.45123,                     // The price the trade was executed at
  "takeProfit" : 1.7,                    // The take-profit associated with the trade, if any
  "stopLoss" : 1.4,                      // The stop-loss associated with the trade, if any
  "trailingStop" : 50                    // The trailing stop associated with the trade, if any
  "trailingAmount" : 1.44613             // The trailing amount associated with the trade, if any.
                                            Returns -1 if our trailing amount server is unavailable
}

既存のチケットを変更する

PATCH /v1/accounts/:account_id/trades/:trade_id

入力データパラメータ

注: 特定したパラメータのみが変更され、残りのパラメータは変更されません。 任意のパラメータを削除したい場合は値に0を設定してください。

stopLoss
任意 ストップロス価格
takeProfit
任意 テイクプロフィット価格
trailingStop
任意 トレーリングストップのディスタンス(pipsで小数第一位まで)

$curl -X PATCH -d "stopLoss=1.6" "http://api-sandbox.oanda.com/v1/accounts/12345/trades/43211"

レスポンス

ヘッダ
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 193
ボディ
{
  "id" : 43211,                          // ID
  "units" : 5,                           // 
  "side" : "buy",                        // 
  "instrument" : "EUR_USD",              // 
  "time" : "2013-07-03T14:30:38Z",       //  (RFC3339)
  "price" : 1.45123,                     // 
  "takeProfit" : 1.7,                    //   
  "stopLoss" : 1.6,                      //   
  "trailingStop" : 50                    //   
  "trailingAmount" : 1.44613             //   
                                            trailing amount server-1
}

未決済のチケットをクローズする

DELETE /v1/accounts/:account_id/trades/:trade_id

$curl -X DELETE "http://api-sandbox.oanda.com/v1/accounts/12345/trades/43211"

レスポンス

ヘッダ
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 140
ボディ
{
  "id" : 54332,                   // ID
  "price" : 1.30601,              // 
  "instrument" : "EUR_USD",       // 
  "profit" :  0.005,              // 
  "side" : "sell"                 // 
  "time" : "2013-07-12T16:09:15Z" //  RFC3339)
}