指定の口座で取引可能な銘柄のリスト (通貨ペア、 CFD、および貴金属)を取得します。
GET /v1/instruments
※2015年1月現在日本国内ではCFD、貴金属のお取引は提供しておりません。あらかじめご了承ください。
curl -X GET "http://api-sandbox.oanda.com/v1/instruments?accountId=12345&instruments=AUD_CAD%2CAUD_CHF"
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 264
{
"instruments" : [
{
"instrument" : "AUD_CAD",
"displayName" : "AUD\/CAD",
"pip" : "0.0001",
"maxTradeUnits" : 10000000
},
{
"instrument" : "AUD_CHF",
"displayName" : "AUD\/CHF",
"pip" : "0.0001",
"maxTradeUnits" : 10000000
}
]
}
fields__パラメータがリクエストで設定されていなかった場合は、デフォルトで返信される銘柄フィールドは__instrument、 displayName、 pip、 __maxTradeUnits__となります。
GET /v1/prices
OANDAプラットフォームで取得可能な特定の銘柄のライブレートを取得します。
curl -X GET "http://api-sandbox.oanda.com/v1/prices?instruments=EUR_USD%2CUSD_JPY%2CEUR_CAD"
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 379
{
"prices": [
{
"instrument":"EUR_USD",
"time":"2013-06-21T17:41:04.648747Z", // time in RFC3339 format
"bid":1.31513,
"ask":1.31528
},
{
"instrument":"USD_JPY",
"time":"2013-06-21T17:49:02.475381Z",
"bid":97.618,
"ask":97.633
},
{
"instrument":"EUR_CAD",
"time":"2013-06-21T17:51:38.063560Z",
"bid":1.37489,
"ask":1.37517,
"status": "halted" // このレスポンスのパラメータは当該銘柄がOANDAプラットフォーム上で現在Halted(停止)状態の場合のみ設定されます。
}
]
}
特定銘柄に関する過去データの取得
GET /v1/candles
curl -X GET "http://api-sandbox.oanda.com/v1/candles?instrument=EUR_USD&count=2&candleFormat=midpoint&granularity=D&dailyAlignment=0&alignmentTimezone=America%2FNew_York"
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 429
{
"instrument" : "EUR_USD",
"granularity": "S5",
"candles": [
{
"time": "2013-06-21T17:41:00Z", // time in RFC3339 format
"openMid": 1.30237,
"highMid": 1.30237,
"lowMid": 1.30237,
"closeMid": 1.30237,
"volume" : 5000,
"complete": true
},
{
"time": "2013-06-21T17:41:05Z", // time in RFC3339 format
"openMid": 1.30242,
"highMid": 1.30242,
"lowMid": 1.30242,
"closeMid": 1.30242,
"volume" : 2000,
"complete": true
}
]
}
curl "http://api-sandbox.oanda.com/v1/candles?instrument=EUR_USD&start=2014-06-19T15%3A47%3A40Z&end=2014-06-19T15%3A47%3A50Z"
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 634
{
"instrument" : "EUR_USD",
"granularity" : "S5",
"candles" : [
{
"time" : "2014-06-19T15:47:40.000000Z",
"openBid" : 1.25682,
"openAsk" : 1.25691,
"highBid" : 1.25682,
"highAsk" : 1.25691,
"lowBid" : 1.25642,
"lowAsk" : 1.25651,
"closeBid" : 1.25642,
"closeAsk" : 1.25651,
"volume" : 9,
"complete" : true
},
{
"time" : "2014-06-19T15:47:45.000000Z",
"openBid" : 1.25644,
"openAsk" : 1.25653,
"highBid" : 1.25644,
"highAsk" : 1.25653,
"lowBid" : 1.25634,
"lowAsk" : 1.25643,
"closeBid" : 1.25634,
"closeAsk" : 1.25643,
"volume" : 4,
"complete" : true
}
]
}
可能な値は:
もしgranularityパラメータが設定されなかった場合は、granularity のデフォルト値は”S5”となります。
もし、start と end パラメータが両方設定されていた場合、count は設定されるべきではありません。
もしcandleFormatパラメータが設定されなかった場合、 candleFormat のデフォルト値は”bidask”です。
dailyAlignmentのデフォルト値は、東部夏時間の場合は21であり、東部標準時の場合は22となります。 これはニューヨーク現地時間の17:00に相当します。
alignmentTimezone が設定されなかった場合、alignmentTimezone のデフォルト値は“America/New_York”です。
weeklyAlignment が設定されなかった場合、weeklyAlignment のデフォルト値は“Friday”です。
1 ティックがなかったインターバルについてはローソクは送信されませんので、ギャップが発生します。
2 もし start 及び end の両方のパラメータが設定されなかった場合、 end にはデフォルトとして現在の時刻が設定され、 count 本のローソクが送信されます。
midpoint ティックボリュームを含む中値ベースのローソク
{
"time":<TS>,
"openMid":<O_m>,
"highMid":<H_m>,
"lowMid":<L_m>,
"closeMid":<C_m>,
"volume":<V>,
"complete":<DB>
}
bidask ティックボリュームを含むBID/ASKベースのローソク
{
"time":<TS>,
"openBid":<O_b>,
"openAsk":<O_a>,
"highBid":<H_b>,
"highAsk":<H_a>,
"lowBid":<L_b>,
"lowAsk":<L_a>,
"closeBid":<C_b>,
"closeAsk":<C_a>,
"volume":<V>,
"complete":<DB>
}
以上のローソクにおける各フィールドは以下の意味を持っています: