MtGox/API/HTTP/v0 - Revision history

Neofutur: /* 0/bitcoin_tx */

2013-04-12T11:34:35Z

0/bitcoin_tx

← Older revision		Revision as of 11:34, 12 April 2013
Line 277:		Line 277:

	will show the list of all unconfirmed pending txs tracked by mtgox		will show the list of all unconfirmed pending txs tracked by mtgox

			when you place a tx on mtgox, we try to broadcast it, but if after 2 hours it hasn't appeared in the blockchain, it'll appear in this API

			containing the raw signed tx number in base64

	=== pending transactions ===		=== pending transactions ===

GenBTC: /* HTTP API version 0 methods */

2013-04-04T22:41:20Z

HTTP API version 0 methods

← Older revision		Revision as of 22:41, 4 April 2013
Line 115:		Line 115:
	=== 0/redeemCode.php ===		=== 0/redeemCode.php ===
	Used to redeem a mtgox coupon code		Used to redeem a mtgox coupon code

			Most likely requires deposit privileges on the API Key.

	https://data.mtgox.com/api/0/redeemCode.php		https://data.mtgox.com/api/0/redeemCode.php
Line 123:		Line 125:

	=== 0/redeemBtcPrivkey.php ===		=== 0/redeemBtcPrivkey.php ===
			used to redeem a private key via the API

	~~used to redeem a private key via~~ the API		Most likely requires deposit privileges on the API Key.

	https://data.mtgox.com/api/0/redeemBtcPrivkey.php		https://data.mtgox.com/api/0/redeemBtcPrivkey.php
Line 137:		Line 140:
	=== 0/withdraw.php ===		=== 0/withdraw.php ===
	withdraw / Send BTC		withdraw / Send BTC
			You NEED Withdraw privileges set up to enabled on the API key.

	https://data.mtgox.com/api/0/withdraw.php		https://data.mtgox.com/api/0/withdraw.php
Line 159:		Line 163:
	=== 0/btcAddress.php ===		=== 0/btcAddress.php ===
	get a bitcoin deposit adress for your account		get a bitcoin deposit adress for your account

			You NEED Deposit privileges set up to enabled on the API key.

	https://data.mtgox.com/api/0/btcAddress.php		https://data.mtgox.com/api/0/btcAddress.php

GenBTC: /* 0/btcAddress.php */

2013-04-04T22:39:23Z

0/btcAddress.php

← Older revision		Revision as of 22:39, 4 April 2013
Line 168:		Line 168:

	* returns a bitcoin deposit address		* returns a bitcoin deposit address

			;Example response:
			{u'return': {u'addr': u'17A1vbzQ39o8cGNnpqx8UvXNrhqwAEP8wY'}, u'result': u'success'}

	=== 0/history_[CUR].csv ===		=== 0/history_[CUR].csv ===

GenBTC: /* 0/withdraw.php */

2013-04-04T22:38:28Z

0/withdraw.php

← Older revision		Revision as of 22:38, 4 April 2013
Line 152:		Line 152:
	{u'status': u'Funds are on their way (bitcoin transaction: 2426f19cda3332b25d02daf2479bc558b243a0631584d75dd2bb8ee45f50a118)',		{u'status': u'Funds are on their way (bitcoin transaction: 2426f19cda3332b25d02daf2479bc558b243a0631584d75dd2bb8ee45f50a118)',
	<br/> u'reference': u'58a9e537-e64a-4e66-bc45-31c1bdc3a91b'}		<br/> u'reference': u'58a9e537-e64a-4e66-bc45-31c1bdc3a91b'}
			;Example error:
			{u'error': u'Please enter a valid amount'}

	To make a withdraw in another Currency , use group1=USD2CODE and add a Currency parameter ( example Currency=EUR to get a mtgox EUR coupon )		To make a withdraw in another Currency , use group1=USD2CODE and add a Currency parameter ( example Currency=EUR to get a mtgox EUR coupon )

GenBTC: /* HTTP API version 0 methods */

2013-04-02T09:50:08Z

HTTP API version 0 methods

← Older revision		Revision as of 09:50, 2 April 2013
Line 45:		Line 45:
	Get your current balance		Get your current balance

	https://mtgox.com/api/0/getFunds.php		https://data.mtgox.com/api/0/getFunds.php

	getfunds is now deprecated since multi currency, please use info.php		getfunds is now deprecated since multi currency, please use info.php
Line 59:		Line 59:
	Place an order to Buy BTC		Place an order to Buy BTC

	https://mtgox.com/api/0/buyBTC.php		https://data.mtgox.com/api/0/buyBTC.php

	POST data: amount=#&price=#&Currency=~~PLN~~		POST data: amount=#&price=#&Currency=USD

	returns a list of your open orders		returns a list of your open orders

	you can omit the price to do a market order		you can omit the price to do a market order

			This will return THE ENTIRE list of all open orders (after the cancel). <br>
			Consider switching to V1/V2 if you do not need the complete list returned after every call to buyBTC.php <br>

	=== 0/sellBTC.php ===		=== 0/sellBTC.php ===
	Place an order to Sell BTC		Place an order to Sell BTC

	https://mtgox.com/api/0/sellBTC.php		https://data.mtgox.com/api/0/sellBTC.php

	POST data: &amount=#&price=#&Currency=~~PLN~~		POST data: &amount=#&price=#&Currency=USD

	returns a list of your open orders		returns a list of your open orders

	you can omit the price to do a market order		you can omit the price to do a market order

			This will return THE ENTIRE list of all open orders (after the cancel). <br>
			Consider switching to V1/V2 if you do not need the complete list returned after every call to sellBTC.php <br>

	=== 0/getOrders.php ===		=== 0/getOrders.php ===
	Fetch a list of your open Orders		Fetch a list of your open Orders

	https://mtgox.com/api/0/getOrders.php		https://data.mtgox.com/api/0/getOrders.php

	oid: Order ID		oid: Order ID
Line 88:		Line 94:

	status: 1 for active, 2 for not enough funds		status: 1 for active, 2 for not enough funds

			This will return THE ENTIRE list of all open orders (after the cancel). <br>
			Consider switching to V1/V2 if you do not need the complete list returned after every call to getOrders.php <br>
			This will break apart "Not enough funds" Orders into two parts, the first part will be the order ID with the amount of the valid portion. The second part will have an "X" in front of the Order_ID (so it will be 1 char longer) with the amount of the INVALID portion. (that you can't afford)

	=== 0/cancelOrder.php ===		=== 0/cancelOrder.php ===
	Cancel an order		Cancel an order

	https://mtgox.com/api/0/cancelOrder.php		https://data.mtgox.com/api/0/cancelOrder.php

	POST data: oid=#&type=#		POST data: oid=#&type=#
Line 106:		Line 116:
	Used to redeem a mtgox coupon code		Used to redeem a mtgox coupon code

	https://mtgox.com/api/0/redeemCode.php		https://data.mtgox.com/api/0/redeemCode.php

	* call with a post parameter "code" containing the code to redeem		* call with a post parameter "code" containing the code to redeem
Line 116:		Line 126:
	used to redeem a private key via the API		used to redeem a private key via the API

	https://mtgox.com/api/0/redeemBtcPrivkey.php		https://data.mtgox.com/api/0/redeemBtcPrivkey.php

	* parameters :		* parameters :
Line 128:		Line 138:
	withdraw / Send BTC		withdraw / Send BTC

	https://mtgox.com/api/0/withdraw.php		https://data.mtgox.com/api/0/withdraw.php

	POST data: group1=BTC&btca=bitcoin_address_to_send_to&amount=#		POST data: group1=BTC&btca=bitcoin_address_to_send_to&amount=#
Line 148:		Line 158:
	get a bitcoin deposit adress for your account		get a bitcoin deposit adress for your account

	https://mtgox.com/api/0/btcAddress.php		https://data.mtgox.com/api/0/btcAddress.php

	* pass POST data "description" to add a description that will appear in your history when this BTC address receive a deposit		* pass POST data "description" to add a description that will appear in your history when this BTC address receive a deposit
Line 161:		Line 171:
	Allows downloading your activity history for a given currency (BTC or USD for now).		Allows downloading your activity history for a given currency (BTC or USD for now).

	https://mtgox.com/api/0/history_BTC.csv		https://data.mtgox.com/api/0/history_BTC.csv

	https://mtgox.com/api/0/history_USD.csv		https://data.mtgox.com/api/0/history_USD.csv

	encoding is utf-8		encoding is utf-8
Line 169:		Line 179:
	=== 0/info.php ===		=== 0/info.php ===

	https://mtgox.com/api/0/info.php		https://data.mtgox.com/api/0/info.php

	returns info about your account, funds, fees, API privileges, withdraw limits . . .		returns info about your account, funds, fees, API privileges, withdraw limits . . .

GenBTC: /* 0/cancelOrder.php */

2013-04-02T09:45:54Z

0/cancelOrder.php

← Older revision		Revision as of 09:45, 2 April 2013
Line 99:		Line 99:

	type: 1 for sell order or 2 for buy order		type: 1 for sell order or 2 for buy order

			This will return THE ENTIRE list of all open orders (after the cancel).<br>
			Consider switching to V1/V2 if you do not need the complete list returned after every call to cancelOrder.php

	=== 0/redeemCode.php ===		=== 0/redeemCode.php ===

GenBTC at 08:07, 21 March 2013

2013-03-21T08:07:50Z

← Older revision		Revision as of 08:07, 21 March 2013
Line 1:		Line 1:
	Version 0 of the HTTP API is available at https://mtgox.com/api/0.		Version 0 of the HTTP API is available at https://data.mtgox.com/api/0/.<br />
			This API is becoming deprecated. You will see warning messages in the responses when you use this API.<br />
			The URLs used as titles below already include the 0 as part of the url shown above. There is no need to repeat this.

	== HTTP API version 0 methods ==		== HTTP API version 0 methods ==

Neofutur: /* pending transactions */

2013-03-10T00:42:39Z

pending transactions

← Older revision		Revision as of 00:42, 10 March 2013
Line 254:		Line 254:
	=== pending transactions ===		=== pending transactions ===

	https://mtgox.com/api/0/bitcoin_tx.php		https://data.mtgox.com/api/0/bitcoin_tx.php

	gives a list of the transaction numbers for transactions broadcasted by mtgox to the bitcoin network, but not yet included in a block		gives a list of the transaction numbers for transactions broadcasted by mtgox to the bitcoin network, but not yet included in a block

Neofutur: /* 0/bitcoin_tx */

2013-03-10T00:42:03Z

0/bitcoin_tx

← Older revision		Revision as of 00:42, 10 March 2013
Line 248:		Line 248:
	=== 0/bitcoin_tx ===		=== 0/bitcoin_tx ===

	https://mtgox.com/api/0/bitcoin_tx.php		https://data.mtgox.com/api/0/bitcoin_tx.php

	will show the list of all unconfirmed pending txs tracked by mtgox		will show the list of all unconfirmed pending txs tracked by mtgox

Neofutur: /* 0/ticker */

2013-03-10T00:41:28Z

0/ticker

← Older revision		Revision as of 00:41, 10 March 2013
Line 221:		Line 221:
	=== 0/ticker ===		=== 0/ticker ===

	http://mtgox.com/api/0/data/ticker.php		http://data.mtgox.com/api/0/data/ticker.php

	returns the current ticker :		returns the current ticker :