MtGox/API/HTTP/v0
HTTP APIのバージョン0はhttps://data.mtgox.com/api/0/から入手できます
このAPIは非推奨になっています。このAPIを使用すると、応答に警告メッセージが表示されます。
下のタイトルとして既に使用されているURLには、上記のURLの一部として0が含まれています。これを繰り返す必要はありません。
目次
- 1 HTTP API バージョン0のメソッド
- 1.1 0/data/getTrades.php
- 1.2 0 / getDepth.php
- 1.3 0 / getFunds.php
- 1.4 0 / buyBTC.php
- 1.5 0 / sellBTC.php
- 1.6 0 / getOrders.php
- 1.7 0 / cancelOrder.php
- 1.8 0 / redeemCode.php
- 1.9 0 / redeemBtcPrivkey.php
- 1.10 0 / withdraw.php
- 1.11 0 / btcAddress.php
- 1.12 0 / history_ [CUR] .csv
- 1.13 0/info.php
- 1.14 0/ticker
- 1.15 0/bitcoin_tx
- 1.16 保留中のトランザクション
- 2 例とツール
HTTP API バージョン0のメソッド[編集]
0/data/getTrades.php[編集]
これにより、過去24時間に発生したすべての取引を検索することができます。返されたデータはキャッシュされ、最新のアクティビティを反映していない可能性があります。
http://data.mtgox.com/api/0/data/getTrades.php?Currency=USD http://data.mtgox.com/api/0/data/getTrades.php?Currency=USD&since=1
パラメーター:
- since: "since"にtidを渡すことで、その取引以来のすべての取引を検索できます。渡されたIDは存在しない可能性があります。つまりすべての取引を当初から取得するには、https://mtgox.com/code/data/getTrades.php?since=0を呼び出します。これは100回の取引しか返さないので、その後にインポートした最新の取引を渡すことで再度メソッドを呼び出すことができます。
- データは次のような標準のjson形式で返されます。 :
[
{"date":1279408157,
"price":"0.04951",
"amount":"20",
"price_int":"4951",
"amount_int":"2000000000",
"tid":"1",
"price_currency":"USD",
"item":"BTC",
"trade_type":""
"primary":"Y"
},
{"date":1279424586,"price":"0.05941","amount":"50.01","price_int":"5941","amount_int":"5001000000","tid":"2","price_currency":"USD","item":"BTC","trade_type":""}]
0 / getDepth.php[編集]
現在の市場の深さを取得する
https://data.mtgox.com/api/0/data/getDepth.php?Currency=PLN https://data.mtgox.com/api/0/data/getDepth.php?Currency=AUD https://data.mtgox.com/api/0/data/getDepth.php?Currency=USD
{"asks":[[11.37998,22.89],[11.38,42.44592124],[11.3844,165],[11.599,1000]],"bids":[[10.7078,0.3],[10.70964,0.02024837],[10.70978,0.55822],[11.2903,2.8]]}
0 / getFunds.php[編集]
現在の残高を取得する
https://data.mtgox.com/api/0/getFunds.php
getfundsはマルチ通貨よりも非難されています。info.phpを使用してください。
{
["usds"]=> "18.74737"
["btcs"]=> "0.01733"
}
0 / buyBTC.php[編集]
BTCを購入するための発注
https://data.mtgox.com/api/0/buyBTC.php
POSTデータ:金額=#&価格=#&通貨= USD
開いている注文のリストを返します。
あなたは市場の注文をするために価格を省略することができます。
これにより、すべての未処理注文(キャンセル後)の全一覧が返されます。
buyBTC.phpを呼び出すたびにリスト全体が返される必要がない場合は、V1 / V2に切り替えることを検討してください。
0 / sellBTC.php[編集]
BTCを売るために注文する
https://data.mtgox.com/api/0/sellBTC.php
POSTデータ:&amount =#&price =#&通貨= USD
開いている注文のリストを返します
あなたは市場の注文をするために価格を省略することができます
これにより、すべての未処理注文(キャンセル後)の全一覧が返されます。
sellBTC.phpを呼び出すたびにリスト全体が返される必要がない場合は、V1 / V2に切り替えることを検討してください
0 / getOrders.php[編集]
開いているオーダーのリストを取得する
https://data.mtgox.com/api/0/getOrders.php
oid:注文ID
タイプ:売り注文の場合は1、買い注文の場合は2
ステータス:アクティブな場合は1、十分な資金がない場合は2
これにより、すべての未処理注文(キャンセル後)の全一覧が返されます。
getOrders.phpを呼び出すたびにリスト全体が返される必要がない場合は、V1 / V2に切り替えることを検討してください。
これは、 "不十分な資金"注文を2つの部分に分解します。最初の部分は、有効な部分の額を含む注文IDになります。 2番目の部分は、Order_IDの前に "X"が付いています(したがって1文字長くなります)。 (あなたは余裕がない)
0 / cancelOrder.php[編集]
注文をキャンセルする
https://data.mtgox.com/api/0/cancelOrder.php
POSTデータ:oid =#&type =#
oid:注文ID
タイプ:売り注文の場合は1、買い注文の場合は2
これにより、すべての未処理注文(キャンセル後)の全一覧が返されます。
cancelOrder.phpを呼び出すたびにリスト全体が返される必要がない場合は、V1 / V2に切り替えることを検討してください
0 / redeemCode.php[編集]
mtgoxクーポンコードの交換に使用
ほとんどの場合、APIキーの入金特権が必要です。
https://data.mtgox.com/api/0/redeemCode.php
- 使用するコードを含むポストパラメータ "code"で呼び出す
- 金額(浮動小数点数のコード)、通貨(3文字、BTCまたはUSD)、参照(トランザクションID)、およびステータスを含む配列を返します。
0 / redeemBtcPrivkey.php[編集]
APIを介して秘密鍵を引き換えるために使用される
ほとんどの場合、APIキーの入金特権が必要です。
https://data.mtgox.com/api/0/redeemBtcPrivkey.php
- パラメーター :
"キーコード "keytype": "auto" "description":説明
- は、この秘密鍵のbtcアドレスとbtcsの総数を返します
0 / withdraw.php[編集]
BTCを引き出す/送る APIキーで有効に設定されている引き出し権限が必要です。
https://data.mtgox.com/api/0/withdraw.php
POSTデータ:group1 = BTC&btca = bitcoin_address_to_send_to&amount =#
- btcaのパラメータを渡してbtcのアドレスに引き出す
- クーポンのグループ1を渡す:BTC2CODEまたはUSD2CODE
- dwolla withdrawの場合、group1 = DWUSD&dwaccount = XXX-XXX-XXXX(btca = xxxxxxxなし)を渡します。
- 新しいgreenaddress機能を使用するには、green = 1を渡します([[GreenAddress]を参照))
受信アドレス(btca)がMtGox上にあっても、bitcoinブロックチェーンを使用するには、no_instant = 1を渡します
- 成功した場合のコードとステータスの返却
- 応答の例:
{u'status ':u'Fundsが進行中です(bitcoinトランザクション:2426f19cda3332b25d02daf2479bc558b243a0631584d75dd2bb8ee45f50a118)
u'reference ':u'58a9e537-e64a-4e66-bc45-31c1bdc3a91b'}
- エラー例:
{u'error ':有効な金額を入力してください'}
別の通貨で引き落とすには、group1 = USD2CODEを使用して通貨パラメータを追加します(通貨= EURでmtgox EURクーポンを取得します)
0 / btcAddress.php[編集]
あなたのアカウントのビットコイン預託口を取得する
あなたはAPIキーで有効に設定されたデポジット特権が必要です。
https://data.mtgox.com/api/0/btcAddress.php
- POSTデータの「説明」を渡して、このBTCアドレスが入金されたときに履歴に表示される説明を追加します
- この新しいアドレスが資金を受け取るたびにmtgoxがpingするURLを追加するためにPOSTデータ "ipn"を渡す
ipnが動作するためには、上記の説明も必要です。
- ビットコイン預託住所を返す
- 応答の例:
{u'return ':{u'addr':u'17A1vbzQ39o8cGNnpqx8UvXNrhqwAEP8wY '}、u'result':u'success '}
0 / history_ [CUR] .csv[編集]
所定の通貨(現在はBTCまたはUSD)のアクティビティ履歴をダウンロードできます。
https://data.mtgox.com/api/0/history_BTC.csv
https://data.mtgox.com/api/0/history_USD.csv
エンコーディングはutf-8です
0/info.php[編集]
https://data.mtgox.com/api/0/info.php
あなたのアカウント、資金、手数料、API特権、引き出し制限に関する情報を返します
{
["Login"]=> "some_user"
["Index"]=> "111111"
["Rights"]=> {
[0]=> "get_info"
[1]=> "trade"
}
["Language"]=> "en_US"
["Created"]=> "2012-03-12 17:58:53"
["Last_Login"]=> "2012-07-10 09:19:56"
["Wallets"]=>
{
["BTC"]=>
{
["Balance"]=>
{
["value"]=> "0.01733000"
["value_int"]=> "1733000"
["display"]=> "0.01733000| BTC"
["display_short"]=> "0.02| BTC"
["currency"]=> "BTC"
}
["Operations"]=> ''
["Daily_Withdraw_Limit"]=>
{
["value"]=> "200.00000000"
["value_int"]=> "20000000000"
["display"]=> "200.00000000| BTC"
["display_short"]=> "200.00| BTC"
["currency"]=> "BTC"
}
["Monthly_Withdraw_Limit"]=> ''
["Max_Withdraw"]=>
{
["value"]=> "200.00000000"
["value_int"]=> "20000000000"
["display"]=> "200.00000000| BTC"
["display_short"]=> "200.00| BTC"
["currency"]=> "BTC"
}
}
["EUR"]=>
{
...
}
}
["Trade_Fee"]=> float(0.6)
}
0/ticker[編集]
http://data.mtgox.com/api/0/data/ticker.php
現在のティッカーを返します。:
{"ticker":
{
"high":5.70653,
"low":5.4145,
"avg":5.561388723,
"vwap":5.610932845,
"vol":55698,
"last":5.56915,
"buy":5.51326,
"sell":5.5672
}
}
高、低、vol、平均、vwapの時間枠で 24時間滑ります。
vwapとは何ですか?
http://en.wikipedia.org/wiki/VWAPをご覧ください。
0/bitcoin_tx[編集]
https://data.mtgox.com/api/0/bitcoin_tx.php
mtgoxによって追跡されたすべての確認されていない保留中のtxのリストを表示します
mtgoxにtxを置くとブロードキャストしようとしますが、2時間後にブロックチェーンに表示されなければ、このAPIに表示されます。
(base64で未署名のtx番号を含む)
保留中のトランザクション[編集]
https://data.mtgox.com/api/0/bitcoin_tx.php
mtgoxによってBitcoinネットワークにブロードキャストされたトランザクションのトランザクション番号のリストを示しますが、まだブロックには含まれていません。
例とツール[編集]
シェル型CLI[編集]
Python:http://www.goxsh.info/
Perlモジュール[編集]
その他[編集]
https:http://stackoverflow.com/questions/7046370/https-request-with-boost-asio-and-openssl
https://github.com/sje397/mtgoxplasmoid
モジュールperl:http://search.cpan.org/~mndrix/Finance-MtGox-0.02/
PHPダッシュボード[編集]
https://github.com/Lexiks/MyBitBoard
PHPティッカーと価格設定ツール[編集]
https://github.com/neofutur/bitcoin_simple_php_tools
Bashの貿易の歴史[編集]
bash:https://bitcointalk.org/index.php?topic=39402.0