MtGox/API: Difference between revisions

From Bitcoin Wiki
Jump to navigation Jump to search
Neofutur (talk | contribs)
No edit summary
MagicalTux (talk | contribs)
No edit summary
 
(5 intermediate revisions by 2 users not shown)
Line 4: Line 4:


* [[MtGox/API/HTTP|HTTP API]]  
* [[MtGox/API/HTTP|HTTP API]]  
* [[MtGox/API/Pubnub|Streaming Pubnub API]]
* [[MtGox/API/Streaming|Streaming websocket API]]
* [[MtGox/API/Streaming|Streaming websocket API]]


Line 20: Line 21:
| BTC (volume, amount) || 1E8 (100,000,000) || 0.00000001
| BTC (volume, amount) || 1E8 (100,000,000) || 0.00000001
|-
|-
| USD (price) || 1E5 (100,000) || 0.00001
| USD, AUD, CAD, CHF, CNY, DKK, EUR, GBP, HKD, NZD, PLN, RUB, SGD, THB, NOK, CZK (price) || 1E5 (100,000) || 0.00001
|-
|-
| JPY (price) || 1E3 (1,000) || 0.001
| JPY, SEK (price) || 1E3 (1,000) || 0.001
|}
|}


Line 30: Line 31:
List of the currency symbols available with the API:
List of the currency symbols available with the API:


USD, AUD, CAD, CHF, CNY, DKK, EUR, GBP, HKD, JPY, NZD, PLN, RUB, SEK, SGD, THB
USD, AUD, CAD, CHF, CNY, DKK, EUR, GBP, HKD, JPY, NZD, PLN, RUB, SEK, SGD, THB, NOK, CZK


==Date and time==
==Date and time==


Most dates you will find in mtgox API are UNIX time
Most dates you will find in mtgox API are UNIX time
See http://en.wikipedia.org/wiki/Unix_time
 
Most programming languages should have tools for managing those timestamps
See http://en.wikipedia.org/wiki/Unix_time
 
Most programming languages should have tools for managing those timestamps
 
==See Also==
 
* [http://bitcointalk.org/index.php?topic=164404.0 MtGox API version 2: Unofficial Documentation]

Latest revision as of 04:19, 15 November 2013

The MtGox API provides methods to access information from the market, place orders, and more.

Two APIs are currently available:

Number Formats

In the "old API", currency- and amount-values (price, volume,...) were given as float. These values are likely being deprecated and replaced by fields of the same name with "_int" as suffix. These are fixed-decimal, so you have to move the decimal point yourself (divide). The exponent differs based on the kind of the value.

In order to convert the int to a decimal you can...

kind of field ...divide by ...multiply by
BTC (volume, amount) 1E8 (100,000,000) 0.00000001
USD, AUD, CAD, CHF, CNY, DKK, EUR, GBP, HKD, NZD, PLN, RUB, SGD, THB, NOK, CZK (price) 1E5 (100,000) 0.00001
JPY, SEK (price) 1E3 (1,000) 0.001

Implementation advice: it's probably best to use int or Decimal (if your language/db offers such a type) in your clients. Using float will likely lead to nasty rounding problems.

Currency Symbols

List of the currency symbols available with the API:

USD, AUD, CAD, CHF, CNY, DKK, EUR, GBP, HKD, JPY, NZD, PLN, RUB, SEK, SGD, THB, NOK, CZK

Date and time

Most dates you will find in mtgox API are UNIX time

See http://en.wikipedia.org/wiki/Unix_time

Most programming languages should have tools for managing those timestamps

See Also