Developer API
Data Export | Charts | Gadgets

MH Finance provides its data freely to anyone who is reponsible is requesting the data through this API. Anyone who does not adhear to the API guidelines will be revoked from accessing the server.

The API uses REST API protocol via HTTP GET for all requests. Clients may not make more than 100 requests in one hour. Clients are authenticated by IP address.

API Address

All calls should be made to the following address using a HTTP GET request:

http://seventreeweb.com/mousehunt/api

Example

http://seventreeweb.com/mousehunt/api?method=data.current

Output

Currently, the output of all API calls are XML formatted. JSON may be made available in the future.


Quota

A client may make no more than 100 calls to the API per hour. If the quota is exceeded, the client will have to wait one hour before trying to make another call.


Required Parameters

string method Provides the method being passed to the server. (See below)
float v (Optional) The version of the API you want to use. The current version is 1.0.

Methods

data.current

This method gives the most current average price of SB+, the closing price from the previous day, the change in price from the previous day, the volume of cheese traded, the high and low prices for the day, the thirty day high and low prices, and the last time it was updated.

Parameters [None]

data.history

This method returns a list of prices, average price, and volume for a given amount of time. The default is 30 days.

Parameters
string range (Optional) The number of days of data you want to return.

Error Codes

400 Bad Request - An invalid version number was provided.
404 Method Not Found
408 Request Timeout - The client has exceeded the API call quota of 100 per hour.
500 Internal Server Error - MH Finance has been notifed.