CoinWarz API Documentation

CoinWarz provides API access to the crypto currency data listed on coinwarz.com with JSON responses. All API requests require an API key. To generate an API key, please click the "Generate API key" button. In order for an API key to be approved a valid email address is required.

Generate API Key

API Access Levels

Free Access
The free access level is the default access level for all approved API keys. This level allows up to 25 API calls within a 24 hour period and an API usage limit of 1,000 API calls.
Paid Access
The paid access level provides additional API calls within a 24 hour period and a substantially higher API usage limit.
Access Level API Calls within a 24 hour period Usage Limit Fee
Free Access Level 25 API calls 1,000 FREE FREE
Paid Access Level 300 API calls 50,000 $20.00 USD Purchase
Paid Pro Access Level 1,500 API calls 250,000 $50.00 USD Purchase

Any Paid Access Level purchase will automatically add to your existing usage limit. For example, if you have 990 API calls remaining from your Free Access Level usage limit and you purchase the standard Paid Access Level, your usage limit would be increased to 50,990 and your API calls within a 24 hour period would be increased to 300.

If your API usage limit reaches 0 you must purchase a Paid Access Level to replenish your API usage limit and continue using the API.


API Methods

RESTful

All API methods are RESTful APIs:

  • All API calls should be made with HTTP GET
  • All HTTP responses will be in JSON.
  • You can consider any non-200 HTTP response an error. The returned response will contain more information about the error.

Example JSON Response

{ "Success": true, "Message": "Message about the API call" , "Data": {} }

Parameter Data Type Description
Success Boolean This parameter indicates if the API call was successful or unsuccessful.
Message String This parameter provides messages about the API call for both successful or unsuccessful API calls.
Data JSON Object or JSON Array This parameter provides the JSON Object or JSON Array data for the given API call. If the API call was unsuccessful, this parameter may be null.

API Key Information API

The API Key Information API provides information about the API Key provided.

API Endpoint

http://www.coinwarz.com/v1/api/apikeyinfo?apikey=YOUR_API_KEY

API Call Usage
This value will be deducted from your API usage limit each time you successfully call this API.

0 API Call Usage

Input Parameters
All input parameters are required and not case sensitive.

Parameter Data Type Description
ApiKey String Provide your approved API key for this parameter.

Output JSON Parameters

Parameter Data Type Description
Success Boolean This parameter indicates if the API call was successful or unsuccessful.
Message String This parameter provides messages about the API call for both successful or unsuccessful API calls.
Data JSON Object This parameter provides the JSON Object information for the API Key. If the API call was unsuccessful, this parameter may be null.

Data JSON Object Parameters

Parameter Data Type Description
ApiKey String This parameter provides the API Key.
AccessLevel String This parameter provides the access level for the given API Key.
ApiUsageLimit Number This parameter provides the API usage limit based on the access level for the given API Key.
ApiUsageAvailable Number This parameter provides the total number of API calls left or available for the given API Key.
DailyUsageLimit Number This parameter provides the Daily API usage limit based on the access level for the given API Key.
DailyUsageAvailable Number This parameter provides the number of daily (within the last 24 hours) API calls left or available for the given API Key.
Approved Boolean This parameter indicates if the API Key has been approved or not.

Example JSON Response

Example API Key Information API JSON Response


Mining Profitability API

The Mining Profitability API provides profitability data listed on CoinWarz.com. This data can be for all coins or for specific hashing algorithms: SHA-256, Scrypt, Scrypt-N, X11, X13, Keccak, Quark, Groestl, JHA, NeoScrypt

API Endpoint

http://www.coinwarz.com/v1/api/profitability/?apikey=YOUR_API_KEY&algo=all

API Call Usage
This value will be deducted from your API usage limit each time you successfully call this API.

1 API Call Usage

Required Input Parameters
All input parameters are required and not case sensitive.

Parameter Data Type Description
ApiKey String Provide your approved API key for this parameter.
Algo String Provide one of the the following values for this parameter:
all, sha-256, scrypt, scrypt-n, x11, x13, keccak, quark, groestl, jha, neoscrypt

Optional Input Parameters
The following input parameters are optional, not case sensitive, and will use the specified default value if not provided.

Parameter Data Type Default Value Description
sha256HashRate Number 880.00
( 880.00 GH/s)
Provide the SHA-256 Hash Rate in GH/s when using all or sha-256 for the Algo parameter.
sha256Power Number 700.00
(700.00 Watts)
Provide the SHA-256 Power wattage when using all or sha-256 for the Algo parameter.
sha256PowerCost Number 0.10
(0.10 $/kWh)
Provide the SHA-256 Power Cost (USD) per KWh when using all or sha-256 for the Algo parameter.
scryptHashRate Number 40,000.00
( 40,000.00 KH/s)
Provide the Scrypt Hash Rate in KH/s when using all or scrypt for the Algo parameter.
scryptPower Number 1,000.00
(1,000.00 Watts)
Provide the Scrypt Power wattage when using all or scrypt for the Algo parameter.
scryptPowerCost Number 0.10
(0.10 $/kWh)
Provide the Scrypt Power Cost (USD) per KWh when using all or scrypt for the Algo parameter.
scryptnHashRate Number 875.00
( 875.00 KH/s)
Provide the Scrypt-N Hash Rate in KH/s when using all or scrypt-n for the Algo parameter.
scryptnPower Number 420.00
(420.00 Watts)
Provide the Scrypt-N Power wattage when using all or scrypt-n for the Algo parameter.
scryptnPowerCost Number 0.10
(0.10 $/kWh)
Provide the Scrypt-N Power Cost (USD) per KWh when using all or scrypt-n for the Algo parameter.
x11HashRate Number 9,000.00
( 9,000.00 KH/s)
Provide the X11 Hash Rate in KH/s when using all or x11 for the Algo parameter.
x11Power Number 400.00
(400.00 Watts)
Provide the X11 Power wattage when using all or x11 for the Algo parameter.
x11PowerCost Number 0.10
(0.10 $/kWh)
Provide the X11 Power Cost (USD) per KWh when using all or x11 for the Algo parameter.
x13HashRate Number 6,500.00
( 6,500.00 KH/s)
Provide the X13 Hash Rate in KH/s when using all or x13 for the Algo parameter.
x13Power Number 400.00
(400.00 Watts)
Provide the X13 Power wattage when using all or x13 for the Algo parameter.
x13PowerCost Number 0.10
(0.10 $/kWh)
Provide the X13 Power Cost (USD) per KWh when using all or x13 for the Algo parameter.
keccakHashRate Number 840.00
( 840.00 MH/s)
Provide the Keccak Hash Rate in MH/s when using all or keccak for the Algo parameter.
keccakPower Number 550.00
(550.00 Watts)
Provide the Keccak Power wattage when using all or keccak for the Algo parameter.
keccakPowerCost Number 0.10
(0.10 $/kWh)
Provide the Keccak Power Cost (USD) per KWh when using all or keccak for the Algo parameter.
quarkHashRate Number 4,200.00
( 4,200.00 KH/s)
Provide the Quark Hash Rate in KH/s when using all or quark for the Algo parameter.
quarkPower Number 550.00
(550.00 Watts)
Provide the Quark Power wattage when using all or quark for the Algo parameter.
quarkPowerCost Number 0.10
(0.10 $/kWh)
Provide the Quark Power Cost (USD) per KWh when using all or quark for the Algo parameter.
groestlHashRate Number 30.00
( 30.00 MH/s)
Provide the Groestl Hash Rate in MH/s when using all or groestl for the Algo parameter.
groestlPower Number 550.00
(550.00 Watts)
Provide the Groestl Power wattage when using all or groestl for the Algo parameter.
groestlPowerCost Number 0.10
(0.10 $/kWh)
Provide the Groestl Power Cost (USD) per KWh when using all or groestl for the Algo parameter.
jhaHashRate Number 14,000.00
( 14,000.00 KH/s)
Provide the JHA Hash Rate in KH/s when using all or jha for the Algo parameter.
jhaPower Number 350.00
(350.00 Watts)
Provide the JHA Power wattage when using all or jha for the Algo parameter.
jhaPowerCost Number 0.10
(0.10 $/kWh)
Provide the JHA Power Cost (USD) per KWh when using all or jha for the Algo parameter.
neoscryptHashRate Number 20.00
( 20.00 KH/s)
Provide the NeoScrypt Hash Rate in KH/s when using all or neoscrypt for the Algo parameter.
neoscryptPower Number 200.00
(200.00 Watts)
Provide the NeoScrypt Power wattage when using all or neoscrypt for the Algo parameter.
neoscryptPowerCost Number 0.10
(0.10 $/kWh)
Provide the NeoScrypt Power Cost (USD) per KWh when using all or neoscrypt for the Algo parameter.

Output JSON Parameters

Parameter Data Type Description
Success Boolean This parameter indicates if the API call was successful or unsuccessful.
Message String This parameter provides messages about the API call for both successful or unsuccessful API calls.
Data JSON Array This parameter provides the JSON Array data for the coin data. If the API call was unsuccessful, this parameter will be null.

Data JSON Array Parameters

Parameter Data Type Description
CoinName String This parameter provides the Coin Name.
CoinTag String This parameter provides the Coin Tag.
Algorithm String This parameter provides the hashing algorithm used.
Difficulty Number This parameter provides the current difficulty.
BlockReward Number This parameter provides the current block reward.
BlockCount Number This parameter provides the current block count.
ProfitRatio Number This parameter provides the profit ratio against Bitcoin.
AvgProfitRatio Number This parameter provides the average profit ratio against Bitcoin for the last 14 days.
Exchange String This parameter provides the name of the exchange with the current highest exchange rate.
ExchangeRate Number This parameter provides the numeric value of the current highest exchange rate.
ExchangeVolume Number This parameter provides the volume of the current highest exchange rate.
IsBlockExplorerOnline Boolean This parameter indicates if the coin daemon or block explorer is offline. If the value is false, the data for this coin may be out dated and you should be cautious when using the profit ratio for this coin.
IsExchangeOnline Boolean This parameter indicates if the exchange is offline. If the value is false, the data for this coin may be out dated and you should be cautious when using the profit ratio for this coin.
Message String This parameter provides messages about the coin. This parameter is usually empty, unless the coin daemon/block explorer or exchange is offline.
BlockTimeInSeconds Number This parameter provides the block time in seconds for this coin.
HealthStatus String This parameter provides the health status of the coin; Healthy or Unhealthy. If the health status of the coin is Unhealthy you should be cautious when using the profit ratio for this coin. For more information about the Unhealthy status, see the value in the Message parameter.

Example JSON Response

Example Mining Profitability API JSON Response


Coin Information API

The Coin Information API provides coin information listed on CoinWarz.com for a given coin.

API Endpoint

http://www.coinwarz.com/v1/api/coininformation/?apikey=YOUR_API_KEY&cointag=BTC

API Call Usage
This value will be deducted from your API usage limit each time you successfully call this API.

1 API Call Usage

Input Parameters
All input parameters are required and not case sensitive.

Parameter Data Type Description
ApiKey String Provide your approved API key for this parameter.
CoinTag String Provide a valid coin tag for the coin.

Output JSON Parameters

Parameter Data Type Description
Success Boolean This parameter indicates if the API call was successful or unsuccessful.
Message String This parameter provides messages about the API call for both successful or unsuccessful API calls.
Data JSON Object This parameter provides the JSON Object data for the coin data. If the API call was unsuccessful, this parameter will be null.

Data JSON Object Parameters

Parameter Data Type Description
CoinName String This parameter provides the Coin Name.
CoinTag String This parameter provides the Coin Tag.
Algorithm String This parameter provides the hashing algorithm used.
Difficulty Number This parameter provides the current difficulty.
BlockReward Number This parameter provides the current block reward.
BlockCount Number This parameter provides the current block count.
IsBlockExplorerOnline Boolean This parameter indicates if the coin daemon or block explorer is offline. If the value is false, the data for this coin may be out dated and you should be cautious when using the profit ratio for this coin.
IsExchangeOnline Boolean This parameter indicates if the exchange is offline. If the value is false, the data for this coin may be out dated and you should be cautious when using the profit ratio for this coin.
Message String This parameter provides messages about the coin. This parameter is usually empty, unless the coin daemon/block explorer or exchange is offline.
ExchangeRates JSON Array This parameter provides a JSON Array for the list of exchanges.
BlockTimeInSeconds Number This parameter provides the block time in seconds for this coin.
HealthStatus String This parameter provides the health status of the coin; Healthy or Unhealthy. If the health status of the coin is Unhealthy you should be cautious when using the profit ratio for this coin. For more information about the Unhealthy status, see the value in the Message parameter.

ExchangeRates JSON Array Parameters

Parameter Data Type Description
Exchange String This parameter provides the Exchange Name.
ToUSD Number This parameter provides the USD value if any.
ToBTC Number This parameter provides the coin to BTC exchange rate.
Volume Number This parameter provides the trading volume.
TimeStamp Number This parameter is a UNIX timestamp.

Example JSON Response

Example Coin Information API JSON Response